@vard-app/sdk 0.1.3 → 0.1.5

package/dist/index.js

@@ -18,26 +18,27 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   createVard: () => createVard,
-  createVardFetchStore: () => createVardFetchStore
+  createVardFetchStore: () => createVardFetchStore,
+  v: () => v
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/fetch-store.ts
 function createVardFetchStore(options = {}) {
   const {
     apiBase = options.apiBase ?? process.env.VARD_API_BASE ?? process.env.NEXT_PUBLIC_VARD_API_BASE ?? "https://dash.vard.app",
-    workspaceId = options.workspaceId ?? process.env.VARD_WORKSPACE_ID,
     apiKey = options.apiKey ?? process.env.VARD_API_KEY,
     fetchOptions = {}
   } = options;
   let resolvedValues = null;
+  let structuredContent = null;
   let fetchPromise = null;
   async function fetchValues() {
     const isDevelopment = process.env.NODE_ENV === "development";
-    if (!apiKey && !workspaceId) {
+    if (!apiKey) {
       if (!isDevelopment) {
         console.error(
           "\x1B[31m[vard] Missing configuration! VARD_API_KEY is not set.\x1B[0m\nPlease set this environment variable in your production environment."
@@ -47,37 +48,51 @@ function createVardFetchStore(options = {}) {
           "[vard] No API Key found. Running in local fallback mode (using default values)."
         );
       }
-      return /* @__PURE__ */ new Map();
+      return { variables: /* @__PURE__ */ new Map(), structured: {} };
     }
-    const url = apiKey ? `${apiBase}/api/content/variables` : `${apiBase}/v1/workspaces/${workspaceId}/variables`;
+    const url = `${apiBase}/api/content/variables?structured=true`;
     try {
       const res = await fetch(url, {
         ...fetchOptions,
         headers: {
           ...fetchOptions.headers,
-          ...apiKey ? { "X-Vard-API-Key": apiKey } : {}
+          "X-Vard-API-Key": apiKey
         }
       });
       if (!res.ok) {
         console.warn(`[vard] Failed to fetch variables: ${res.status}`);
-        return /* @__PURE__ */ new Map();
+        return { variables: /* @__PURE__ */ new Map(), structured: {} };
       }
       const data = await res.json();
-      return new Map(data.map((v) => [v.key, v.value]));
+      if (Array.isArray(data)) {
+        return {
+          variables: new Map(data.map((v2) => [v2.key, v2.value])),
+          structured: {}
+        };
+      }
+      return {
+        variables: new Map(data.variables.map((v2) => [v2.key, v2.value])),
+        structured: data.structured || {}
+      };
     } catch (err) {
-      return /* @__PURE__ */ new Map();
+      return { variables: /* @__PURE__ */ new Map(), structured: {} };
     }
   }
   return {
     get(key) {
       return resolvedValues?.get(key);
     },
+    getStructured() {
+      return structuredContent;
+    },
     async prefetch() {
       if (resolvedValues) return;
       if (!fetchPromise) {
         fetchPromise = fetchValues();
       }
-      resolvedValues = await fetchPromise;
+      const result = await fetchPromise;
+      resolvedValues = result.variables;
+      structuredContent = result.structured;
     }
   };
 }
@@ -96,7 +111,7 @@ var noopStore = {
   }
 };
 function createVard(options = {}) {
-  const store = options.store ?? (options.apiKey || options.workspaceId ? createVardFetchStore(options) : noopStore);
+  const store = options.store ?? (options.apiKey ? createVardFetchStore(options) : noopStore);
   const registry = [];
   function register(def) {
     if (!registry.find((d) => d.key === def.key)) {
@@ -108,7 +123,85 @@ function createVard(options = {}) {
     }
     return def.defaultValue;
   }
+  function flattenSchema(schema, prefix = "") {
+    const result = {};
+    for (const [key, value] of Object.entries(schema)) {
+      const fullKey = prefix ? `${prefix}.${key}` : key;
+      if (typeof value === "object" && value !== null && "type" in value) {
+        const field = value;
+        if (field.type === "collection") {
+          const collection = field;
+          const listItemSchema = {};
+          for (const [fKey, fVal] of Object.entries(collection.schema)) {
+            listItemSchema[fKey] = fVal.type;
+          }
+          register({
+            key: fullKey,
+            label: labelFromKey(key),
+            type: "list",
+            defaultValue: [],
+            editableBy: "member",
+            listItemSchema,
+            isCollection: true
+          });
+          Object.defineProperty(result, key, {
+            get: () => store.get(fullKey) ?? [],
+            enumerable: true
+          });
+        } else {
+          const vardField = field;
+          register({
+            key: fullKey,
+            label: vardField.label ?? labelFromKey(key),
+            description: vardField.description,
+            type: vardField.type,
+            defaultValue: vardField.default,
+            editableBy: vardField.editableBy ?? "member",
+            group: vardField.group
+          });
+          Object.defineProperty(result, key, {
+            get: () => store.get(fullKey) ?? vardField.default,
+            enumerable: true
+          });
+        }
+      } else if (typeof value === "object" && value !== null) {
+        result[key] = flattenSchema(value, fullKey);
+      }
+    }
+    return result;
+  }
+  if (options.schema && process.env.NODE_ENV === "development" && options.apiKey) {
+    flattenSchema(options.schema);
+    const definitions = [...registry];
+    const apiBase = process.env.VARD_API_BASE ?? process.env.NEXT_PUBLIC_VARD_API_BASE ?? "https://dash.vard.app";
+    fetch(`${apiBase}/api/content/variables/sync`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Vard-API-Key": options.apiKey
+      },
+      body: JSON.stringify({
+        definitions,
+        schema: options.schema
+      })
+    }).catch((err) => console.warn("[vard] Auto-sync failed:", err));
+  }
   const client = {
+    define(schema) {
+      return flattenSchema(schema);
+    },
+    async get() {
+      if (store.prefetch) {
+        await store.prefetch();
+      }
+      if (store.getStructured) {
+        const structured = store.getStructured();
+        if (structured && Object.keys(structured).length > 0) {
+          return structured;
+        }
+      }
+      return flattenSchema(options.schema ?? {});
+    },
     string(key, fallback, opts = {}) {
       return register({
         key,
@@ -209,6 +302,14 @@ function createVard(options = {}) {
         return client.list(key, schema, fallback, { ...opts, group: "Global" });
       }
     },
+    extend(fragment) {
+      const mergedSchema = { ...options.schema ?? {}, ...fragment };
+      return createVard({
+        ...options,
+        schema: mergedSchema,
+        store
+      });
+    },
     getDefinitions() {
       return [...registry];
     },
@@ -220,9 +321,57 @@ function labelFromKey(key) {
   const lastSegment = key.split(".").pop() ?? key;
   return lastSegment.replace(/([A-Z])/g, " $1").replace(/^./, (c) => c.toUpperCase()).trim();
 }
+
+// src/schema.ts
+var v = {
+  string: (defaultValue, opts = {}) => ({
+    type: "string",
+    default: defaultValue,
+    ...opts
+  }),
+  richtext: (defaultValue, opts = {}) => ({
+    type: "richtext",
+    default: defaultValue,
+    ...opts
+  }),
+  color: (defaultValue, opts = {}) => ({
+    type: "color",
+    default: defaultValue,
+    ...opts
+  }),
+  image: (defaultValue, opts = {}) => ({
+    type: "image",
+    default: defaultValue,
+    ...opts
+  }),
+  boolean: (defaultValue, opts = {}) => ({
+    type: "boolean",
+    default: defaultValue,
+    ...opts
+  }),
+  collection: (schema) => ({
+    type: "collection",
+    schema
+  }),
+  /**
+   * Creates a reusable schema fragment that can be merged into a Vard client
+   * via `vard.extend(fragment)`. Co-locate this with your page/component.
+   *
+   * @example
+   * // app/therapists/schema.ts
+   * export const therapistSchema = v.schema({
+   *   therapists: v.collection({ name: v.string(), photo: v.image() }),
+   * });
+   *
+   * // app/therapists/page.tsx
+   * const { therapists } = await vard.extend(therapistSchema).get();
+   */
+  schema: (schema) => schema
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createVard,
-  createVardFetchStore
+  createVardFetchStore,
+  v
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/fetch-store.ts","../src/client.ts"],"sourcesContent":["// Public entrypoint for @vard/sdk\nexport { createVard } from \"./client\";\nexport { createVardFetchStore } from \"./fetch-store\";\nexport type {\n  VardClient,\n  VardOptions,\n  VardStore,\n  VardVariableDefinition,\n  VardVariableType,\n  VardVariableOptions,\n  VardListItemSchema,\n  InferListItem,\n  VardRole,\n} from \"./types\";\n","import type { VardStore } from \"./types\";\n\nexport interface VardFetchStoreOptions {\n  /**\n   * Base URL of the Vard API. Defaults to https://api.vard.app\n   */\n  apiBase?: string;\n\n  /**\n   * Workspace ID (Legacy). Defaults to process.env.VARD_WORKSPACE_ID.\n   */\n  workspaceId?: string;\n\n  /**\n   * API Key for authentication. Defaults to process.env.VARD_API_KEY.\n   */\n  apiKey?: string;\n\n  /**\n   * Custom fetch options (headers, etc.)\n   */\n  fetchOptions?: RequestInit;\n}\n\n/**\n * Creates a universal VardStore that fetches variable values from the Vard API.\n * Works in any environment with a global `fetch` (Browsers, Node 18+, Bun, Deno).\n */\nexport function createVardFetchStore(\n  options: VardFetchStoreOptions = {}\n): VardStore & { prefetch(): Promise<void> } {\n  const {\n    apiBase = options.apiBase ??\n      process.env.VARD_API_BASE ??\n      process.env.NEXT_PUBLIC_VARD_API_BASE ??\n      \"https://dash.vard.app\",\n    workspaceId = options.workspaceId ?? process.env.VARD_WORKSPACE_ID,\n    apiKey = options.apiKey ?? process.env.VARD_API_KEY,\n    fetchOptions = {},\n  } = options;\n\n  let resolvedValues: Map<string, unknown> | null = null;\n  let fetchPromise: Promise<Map<string, unknown>> | null = null;\n\n  async function fetchValues(): Promise<Map<string, unknown>> {\n    const isDevelopment = process.env.NODE_ENV === \"development\";\n\n    if (!apiKey && !workspaceId) {\n      if (!isDevelopment) {\n        console.error(\n          \"\\x1b[31m[vard] Missing configuration! VARD_API_KEY is not set.\\x1b[0m\\n\" +\n            \"Please set this environment variable in your production environment.\"\n        );\n      } else {\n        console.warn(\n          \"[vard] No API Key found. Running in local fallback mode (using default values).\"\n        );\n      }\n      return new Map();\n    }\n\n    const url = apiKey\n      ? `${apiBase}/api/content/variables`\n      : `${apiBase}/v1/workspaces/${workspaceId}/variables`;\n\n    try {\n      const res = await fetch(url, {\n        ...fetchOptions,\n        headers: {\n          ...fetchOptions.headers,\n          ...(apiKey ? { \"X-Vard-API-Key\": apiKey } : {}),\n        },\n      });\n\n      if (!res.ok) {\n        console.warn(`[vard] Failed to fetch variables: ${res.status}`);\n        return new Map();\n      }\n\n      const data = (await res.json()) as { key: string; value: unknown }[];\n\n      return new Map(data.map((v) => [v.key, v.value]));\n    } catch (err) {\n      return new Map();\n    }\n  }\n\n  return {\n    get(key: string): unknown {\n      return resolvedValues?.get(key);\n    },\n\n    async prefetch(): Promise<void> {\n      if (resolvedValues) return;\n      if (!fetchPromise) {\n        fetchPromise = fetchValues();\n      }\n      resolvedValues = await fetchPromise;\n    },\n  };\n}\n","import type {\n  VardClient,\n  VardOptions,\n  VardStore,\n  VardVariableDefinition,\n  VardVariableOptions,\n  VardListItemSchema,\n  InferListItem,\n  VardRole,\n} from \"./types\";\n\n// ─────────────────────────────────────────────\n// No-op store (used in local dev when no workspaceId is set)\n// ─────────────────────────────────────────────\n\nlet hasLoggedNoop = false;\nconst noopStore: VardStore = {\n  get: () => {\n    if (!hasLoggedNoop && process.env.NODE_ENV !== \"test\") {\n      console.warn(\n        \"[vard] Using default values for all variables because no Store was provided to createVard().\"\n      );\n      hasLoggedNoop = true;\n    }\n    return undefined;\n  },\n};\n\n// ─────────────────────────────────────────────\n// createVard — the main SDK factory\n// ─────────────────────────────────────────────\n\nimport { createVardFetchStore } from \"./fetch-store\";\n\n/**\n * Creates a Vard client instance. Call this once at the top of your site\n * (e.g. in `lib/vard.ts`) and export the result.\n *\n * @example\n * // lib/vard.ts\n * import { createVard } from \"@vard/sdk\"\n * export const vard = createVard({ apiKey: \"...\" })\n *\n * // app/page.tsx\n * import { vard } from \"@/lib/vard\"\n * const title = vard.string(\"hero.title\", \"Hello, world\")\n */\nexport function createVard(options: VardOptions = {}): VardClient {\n  const store: VardStore =\n    options.store ??\n    (options.apiKey || options.workspaceId ? createVardFetchStore(options) : noopStore);\n\n  // Registry of all declared variables — used by CLI + build pipeline\n  const registry: VardVariableDefinition[] = [];\n\n  function register<T>(def: VardVariableDefinition<T>): T {\n    // Avoid double-registering the same key (e.g. in hot-reload scenarios)\n    if (!registry.find((d) => d.key === def.key)) {\n      registry.push(def as VardVariableDefinition);\n    }\n\n    // Resolve value: stored client value takes precedence over the default\n    const stored = store.get(def.key);\n    if (stored !== undefined && stored !== null) {\n      return stored as T;\n    }\n\n    return def.defaultValue;\n  }\n\n  const client: VardClient = {\n    string(key, fallback, opts: VardVariableOptions = {}) {\n      return register<string>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"string\",\n        defaultValue: fallback,\n        editableBy: opts.editableBy ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    richtext(key, fallback, opts: VardVariableOptions = {}) {\n      return register<string>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"richtext\",\n        defaultValue: fallback,\n        editableBy: opts.editableBy ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    color(key, fallback, opts: VardVariableOptions = {}) {\n      return register<string>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"color\",\n        defaultValue: fallback,\n        editableBy: opts.editableBy ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    image(key, fallback, opts: VardVariableOptions = {}) {\n      return register<string>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"image\",\n        defaultValue: fallback,\n        editableBy: opts.editableBy ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    boolean(key, fallback, opts: VardVariableOptions = {}) {\n      return register<boolean>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"boolean\",\n        defaultValue: fallback,\n        editableBy: (opts.editableBy as VardRole) ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    list<S extends VardListItemSchema>(\n      key: string,\n      schema: S,\n      fallback: InferListItem<S>[],\n      opts: VardVariableOptions = {}\n    ): InferListItem<S>[] {\n      return register<InferListItem<S>[]>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"list\",\n        defaultValue: fallback,\n        editableBy: (opts.editableBy as VardRole) ?? \"member\",\n        listItemSchema: schema,\n        group: opts.group,\n      });\n    },\n\n    collection<S extends VardListItemSchema>(\n      key: string,\n      schema: S,\n      fallback: InferListItem<S>[],\n      opts: Omit<VardVariableOptions, \"type\"> = {}\n    ): InferListItem<S>[] {\n      return register<InferListItem<S>[]>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"list\",\n        defaultValue: fallback,\n        editableBy: (opts.editableBy as VardRole) ?? \"member\",\n        listItemSchema: schema,\n        group: opts.group,\n        isCollection: true,\n      });\n    },\n\n    global: {\n      string(key, fallback, opts = {}) {\n        return client.string(key, fallback, { ...opts, group: \"Global\" } as VardVariableOptions);\n      },\n      richtext(key, fallback, opts = {}) {\n        return client.richtext(key, fallback, { ...opts, group: \"Global\" } as VardVariableOptions);\n      },\n      color(key, fallback, opts = {}) {\n        return client.color(key, fallback, { ...opts, group: \"Global\" } as VardVariableOptions);\n      },\n      image(key, fallback, opts = {}) {\n        return client.image(key, fallback, { ...opts, group: \"Global\" } as VardVariableOptions);\n      },\n      boolean(key, fallback, opts = {}) {\n        return client.boolean(key, fallback, { ...opts, group: \"Global\" } as Omit<\n          VardVariableOptions,\n          \"type\"\n        >);\n      },\n      list(key, schema, fallback, opts = {}) {\n        return client.list(key, schema, fallback, { ...opts, group: \"Global\" } as Omit<\n          VardVariableOptions,\n          \"type\"\n        >);\n      },\n    },\n\n    getDefinitions() {\n      return [...registry];\n    },\n    store,\n  };\n\n  return client;\n}\n\n// ─────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────\n\n/**\n * Converts a dot-notation key to a human-readable label.\n * e.g. \"hero.primaryTitle\" → \"Hero Primary Title\"\n */\nfunction labelFromKey(key: string): string {\n  const lastSegment = key.split(\".\").pop() ?? key;\n  // Split on camelCase boundaries and capitalise\n  return lastSegment\n    .replace(/([A-Z])/g, \" $1\")\n    .replace(/^./, (c) => c.toUpperCase())\n    .trim();\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/fetch-store.ts","../src/client.ts","../src/schema.ts"],"sourcesContent":["// Public entrypoint for @vard/sdk\nexport { createVard } from \"./client\";\nexport { createVardFetchStore } from \"./fetch-store\";\nexport { v } from \"./schema\";\nexport type { VardSchema, InferSchema, VardSchemaFragment, MergeSchema } from \"./schema\";\nexport type {\n  VardClient,\n  VardOptions,\n  VardStore,\n  VardVariableDefinition,\n  VardVariableType,\n  VardVariableOptions,\n  VardListItemSchema,\n  InferListItem,\n  VardRole,\n} from \"./types\";\n","import type { VardStore } from \"./types\";\n\nexport interface VardFetchStoreOptions {\n  /**\n   * Base URL of the Vard API. Defaults to https://api.vard.app\n   */\n  apiBase?: string;\n\n  /**\n   * API Key for authentication. Defaults to process.env.VARD_API_KEY.\n   */\n  apiKey?: string;\n\n  /**\n   * Custom fetch options (headers, etc.)\n   */\n  fetchOptions?: RequestInit;\n}\n\n/**\n * Creates a universal VardStore that fetches variable values from the Vard API.\n * Works in any environment with a global `fetch` (Browsers, Node 18+, Bun, Deno).\n */\nexport function createVardFetchStore(\n  options: VardFetchStoreOptions = {}\n): VardStore & { prefetch(): Promise<void> } {\n  const {\n    apiBase = options.apiBase ??\n      process.env.VARD_API_BASE ??\n      process.env.NEXT_PUBLIC_VARD_API_BASE ??\n      \"https://dash.vard.app\",\n    apiKey = options.apiKey ?? process.env.VARD_API_KEY,\n    fetchOptions = {},\n  } = options;\n\n  let resolvedValues: Map<string, unknown> | null = null;\n  let structuredContent: any = null;\n  let fetchPromise: Promise<{ variables: Map<string, unknown>; structured: any }> | null = null;\n\n  async function fetchValues(): Promise<{ variables: Map<string, unknown>; structured: any }> {\n    const isDevelopment = process.env.NODE_ENV === \"development\";\n\n    if (!apiKey) {\n      if (!isDevelopment) {\n        console.error(\n          \"\\x1b[31m[vard] Missing configuration! VARD_API_KEY is not set.\\x1b[0m\\n\" +\n            \"Please set this environment variable in your production environment.\"\n        );\n      } else {\n        console.warn(\n          \"[vard] No API Key found. Running in local fallback mode (using default values).\"\n        );\n      }\n      return { variables: new Map(), structured: {} };\n    }\n\n    const url = `${apiBase}/api/content/variables?structured=true`;\n\n    try {\n      const res = await fetch(url, {\n        ...fetchOptions,\n        headers: {\n          ...fetchOptions.headers,\n          \"X-Vard-API-Key\": apiKey,\n        },\n      });\n\n      if (!res.ok) {\n        console.warn(`[vard] Failed to fetch variables: ${res.status}`);\n        return { variables: new Map(), structured: {} };\n      }\n\n      const data = (await res.json()) as any;\n\n      // Handle both legacy (array) and new (object with structured) responses\n      if (Array.isArray(data)) {\n        return {\n          variables: new Map(data.map((v: any) => [v.key, v.value])),\n          structured: {},\n        };\n      }\n\n      return {\n        variables: new Map(data.variables.map((v: any) => [v.key, v.value])),\n        structured: data.structured || {},\n      };\n    } catch (err) {\n      return { variables: new Map(), structured: {} };\n    }\n  }\n\n  return {\n    get(key: string): unknown {\n      return resolvedValues?.get(key);\n    },\n\n    getStructured(): any {\n      return structuredContent;\n    },\n\n    async prefetch(): Promise<void> {\n      if (resolvedValues) return;\n      if (!fetchPromise) {\n        fetchPromise = fetchValues();\n      }\n      const result = await fetchPromise;\n      resolvedValues = result.variables;\n      structuredContent = result.structured;\n    },\n  };\n}\n","import {\n  VardClient,\n  VardOptions,\n  VardStore,\n  VardVariableDefinition,\n  VardVariableOptions,\n  VardListItemSchema,\n  InferListItem,\n  VardRole,\n  VardVariableType,\n} from \"./types\";\nimport {\n  VardSchema,\n  InferSchema,\n  VardField,\n  VardCollection,\n  VardSchemaFragment,\n  MergeSchema,\n} from \"./schema\";\nimport { createVardFetchStore } from \"./fetch-store\";\n\n// ─────────────────────────────────────────────\n// No-op store (used in local dev when no apiKey is set)\n// ─────────────────────────────────────────────\n\nlet hasLoggedNoop = false;\nconst noopStore: VardStore = {\n  get: () => {\n    if (!hasLoggedNoop && process.env.NODE_ENV !== \"test\") {\n      console.warn(\n        \"[vard] Using default values for all variables because no Store was provided to createVard().\"\n      );\n      hasLoggedNoop = true;\n    }\n    return undefined;\n  },\n};\n\n// ─────────────────────────────────────────────\n// createVard — the main SDK factory\n// ─────────────────────────────────────────────\n\n/**\n * Creates a Vard client instance. Call this once at the top of your site\n * (e.g. in `lib/vard.ts`) and export the result.\n */\nexport function createVard<S extends VardSchema = any>(\n  options: VardOptions<S> = {}\n): VardClient<S> {\n  const store: VardStore =\n    options.store ?? (options.apiKey ? createVardFetchStore(options) : noopStore);\n\n  // Registry of all declared variables — used by CLI + build pipeline\n  const registry: VardVariableDefinition[] = [];\n\n  function register<T>(def: VardVariableDefinition<T>): T {\n    if (!registry.find((d) => d.key === def.key)) {\n      registry.push(def as VardVariableDefinition);\n    }\n\n    const stored = store.get(def.key);\n    if (stored !== undefined && stored !== null) {\n      return stored as T;\n    }\n\n    return def.defaultValue;\n  }\n\n  // ─────────────────────────────────────────────\n  // Schema Traversal\n  // ─────────────────────────────────────────────\n\n  function flattenSchema(schema: VardSchema, prefix = \"\"): any {\n    const result: any = {};\n\n    for (const [key, value] of Object.entries(schema)) {\n      const fullKey = prefix ? `${prefix}.${key}` : key;\n\n      if (typeof value === \"object\" && value !== null && \"type\" in value) {\n        // It's a field or collection\n        const field = value as VardField | VardCollection;\n\n        if (field.type === \"collection\") {\n          // Flatten collection schema but keep it as a 'list' type for the registry\n          const collection = field as VardCollection;\n          const listItemSchema: Record<string, string> = {};\n          for (const [fKey, fVal] of Object.entries(collection.schema)) {\n            listItemSchema[fKey] = (fVal as VardField).type;\n          }\n\n          register({\n            key: fullKey,\n            label: labelFromKey(key),\n            type: \"list\",\n            defaultValue: [],\n            editableBy: \"member\",\n            listItemSchema: listItemSchema as VardListItemSchema,\n            isCollection: true,\n          });\n\n          // In the returned object, this remains a placeholder or is proxied to the store\n          Object.defineProperty(result, key, {\n            get: () => store.get(fullKey) ?? [],\n            enumerable: true,\n          });\n        } else {\n          // It's a plain field\n          const vardField = field as VardField;\n          register({\n            key: fullKey,\n            label: vardField.label ?? labelFromKey(key),\n            description: vardField.description,\n            type: vardField.type,\n            defaultValue: vardField.default,\n            editableBy: vardField.editableBy ?? \"member\",\n            group: vardField.group,\n          });\n\n          Object.defineProperty(result, key, {\n            get: () => store.get(fullKey) ?? vardField.default,\n            enumerable: true,\n          });\n        }\n      } else if (typeof value === \"object\" && value !== null) {\n        // It's a nested object\n        result[key] = flattenSchema(value as VardSchema, fullKey);\n      }\n    }\n\n    return result;\n  }\n\n  // Auto-sync schema in development\n  if (options.schema && process.env.NODE_ENV === \"development\" && options.apiKey) {\n    flattenSchema(options.schema);\n    const definitions = [...registry];\n    const apiBase =\n      process.env.VARD_API_BASE ?? process.env.NEXT_PUBLIC_VARD_API_BASE ?? \"https://dash.vard.app\";\n\n    fetch(`${apiBase}/api/content/variables/sync`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-Vard-API-Key\": options.apiKey,\n      },\n      body: JSON.stringify({\n        definitions,\n        schema: options.schema,\n      }),\n    }).catch((err) => console.warn(\"[vard] Auto-sync failed:\", err));\n  }\n\n  const client: VardClient<S> = {\n    define<NS extends VardSchema>(schema: NS): InferSchema<NS> {\n      return flattenSchema(schema) as InferSchema<NS>;\n    },\n\n    async get(): Promise<InferSchema<S>> {\n      if (store.prefetch) {\n        await store.prefetch();\n      }\n      if (store.getStructured) {\n        const structured = store.getStructured();\n        if (structured && Object.keys(structured).length > 0) {\n          return structured as InferSchema<S>;\n        }\n      }\n      return flattenSchema(options.schema ?? {}) as InferSchema<S>;\n    },\n\n    string(key, fallback, opts: VardVariableOptions = {}) {\n      return register<string>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"string\",\n        defaultValue: fallback,\n        editableBy: opts.editableBy ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    richtext(key, fallback, opts: VardVariableOptions = {}) {\n      return register<string>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"richtext\",\n        defaultValue: fallback,\n        editableBy: opts.editableBy ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    color(key, fallback, opts: VardVariableOptions = {}) {\n      return register<string>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"color\",\n        defaultValue: fallback,\n        editableBy: opts.editableBy ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    image(key, fallback, opts: VardVariableOptions = {}) {\n      return register<string>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"image\",\n        defaultValue: fallback,\n        editableBy: opts.editableBy ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    boolean(key, fallback, opts: VardVariableOptions = {}) {\n      return register<boolean>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"boolean\",\n        defaultValue: fallback,\n        editableBy: (opts.editableBy as VardRole) ?? \"member\",\n        group: opts.group,\n      });\n    },\n\n    list<LS extends VardListItemSchema>(\n      key: string,\n      schema: LS,\n      fallback: InferListItem<LS>[],\n      opts: VardVariableOptions = {}\n    ): InferListItem<LS>[] {\n      return register<InferListItem<LS>[]>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"list\",\n        defaultValue: fallback,\n        editableBy: (opts.editableBy as VardRole) ?? \"member\",\n        listItemSchema: schema,\n        group: opts.group,\n      });\n    },\n\n    collection<LS extends VardListItemSchema>(\n      key: string,\n      schema: LS,\n      fallback: InferListItem<LS>[],\n      opts: Omit<VardVariableOptions, \"type\"> = {}\n    ): InferListItem<LS>[] {\n      return register<InferListItem<LS>[]>({\n        key,\n        label: opts.label ?? labelFromKey(key),\n        description: opts.description,\n        type: \"list\",\n        defaultValue: fallback,\n        editableBy: (opts.editableBy as VardRole) ?? \"member\",\n        listItemSchema: schema,\n        group: opts.group,\n        isCollection: true,\n      });\n    },\n\n    global: {\n      string(key, fallback, opts = {}) {\n        return client.string(key, fallback, { ...opts, group: \"Global\" } as VardVariableOptions);\n      },\n      richtext(key, fallback, opts = {}) {\n        return client.richtext(key, fallback, { ...opts, group: \"Global\" } as VardVariableOptions);\n      },\n      color(key, fallback, opts = {}) {\n        return client.color(key, fallback, { ...opts, group: \"Global\" } as VardVariableOptions);\n      },\n      image(key, fallback, opts = {}) {\n        return client.image(key, fallback, { ...opts, group: \"Global\" } as VardVariableOptions);\n      },\n      boolean(key, fallback, opts = {}) {\n        return client.boolean(key, fallback, { ...opts, group: \"Global\" } as Omit<\n          VardVariableOptions,\n          \"type\"\n        >);\n      },\n      list(key, schema, fallback, opts = {}) {\n        return client.list(key, schema, fallback, { ...opts, group: \"Global\" } as Omit<\n          VardVariableOptions,\n          \"type\"\n        >);\n      },\n    },\n\n    extend<E extends VardSchema>(fragment: VardSchemaFragment<E>): VardClient<MergeSchema<S, E>> {\n      // Merge the base schema with the fragment — the fragment keys win on collision\n      const mergedSchema = { ...(options.schema ?? {}), ...fragment } as unknown as MergeSchema<\n        S,\n        E\n      >;\n      // Return a new client with the merged schema, sharing the same store & registry.\n      // We pass the in-memory store directly so there is no second fetch.\n      return createVard<MergeSchema<S, E>>({\n        ...options,\n        schema: mergedSchema,\n        store,\n      });\n    },\n\n    getDefinitions() {\n      return [...registry];\n    },\n    store,\n  };\n\n  return client;\n}\n\n// ─────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────\n\nfunction labelFromKey(key: string): string {\n  const lastSegment = key.split(\".\").pop() ?? key;\n  return lastSegment\n    .replace(/([A-Z])/g, \" $1\")\n    .replace(/^./, (c) => c.toUpperCase())\n    .trim();\n}\n","import { VardVariableType, VardRole } from \"./types\";\n\nexport interface VardFieldOptions<T = any> {\n  label?: string;\n  description?: string;\n  editableBy?: VardRole;\n  group?: string;\n  default?: T;\n}\n\nexport interface VardField<T = any> extends VardFieldOptions<T> {\n  type: VardVariableType;\n}\n\nexport interface VardCollection<S extends Record<string, VardField | any> = any> {\n  type: \"collection\";\n  schema: S;\n}\n\nexport type VardSchemaValue =\n  | VardField\n  | VardCollection\n  | boolean\n  | { [key: string]: VardSchemaValue };\n\nexport type VardSchema = Record<string, VardSchemaValue>;\n\n/**\n * A branded schema fragment created with `v.schema()`. Use with `vard.extend()`\n * to compose schemas defined across multiple files.\n */\nexport type VardSchemaFragment<S extends VardSchema> = S & {\n  readonly __fragment: true;\n};\n\n/**\n * Merges two VardSchema types, with B's keys overriding A on collision.\n */\nexport type MergeSchema<A extends VardSchema, B extends VardSchema> = Omit<A, keyof B> & B;\n\n// ─────────────────────────────────────────────\n// The `v` helper object for schema definition\n// ─────────────────────────────────────────────\n\nexport const v = {\n  string: (\n    defaultValue?: string,\n    opts: Omit<VardFieldOptions<string>, \"default\"> = {}\n  ): VardField<string> => ({\n    type: \"string\",\n    default: defaultValue,\n    ...opts,\n  }),\n\n  richtext: (\n    defaultValue?: string,\n    opts: Omit<VardFieldOptions<string>, \"default\"> = {}\n  ): VardField<string> => ({\n    type: \"richtext\",\n    default: defaultValue,\n    ...opts,\n  }),\n\n  color: (\n    defaultValue?: string,\n    opts: Omit<VardFieldOptions<string>, \"default\"> = {}\n  ): VardField<string> => ({\n    type: \"color\",\n    default: defaultValue,\n    ...opts,\n  }),\n\n  image: (\n    defaultValue?: string,\n    opts: Omit<VardFieldOptions<string>, \"default\"> = {}\n  ): VardField<string> => ({\n    type: \"image\",\n    default: defaultValue,\n    ...opts,\n  }),\n\n  boolean: (\n    defaultValue?: boolean,\n    opts: Omit<VardFieldOptions<boolean>, \"default\"> = {}\n  ): VardField<boolean> => ({\n    type: \"boolean\",\n    default: defaultValue,\n    ...opts,\n  }),\n\n  collection: <S extends Record<string, VardField | any>>(schema: S): VardCollection<S> => ({\n    type: \"collection\",\n    schema,\n  }),\n\n  /**\n   * Creates a reusable schema fragment that can be merged into a Vard client\n   * via `vard.extend(fragment)`. Co-locate this with your page/component.\n   *\n   * @example\n   * // app/therapists/schema.ts\n   * export const therapistSchema = v.schema({\n   *   therapists: v.collection({ name: v.string(), photo: v.image() }),\n   * });\n   *\n   * // app/therapists/page.tsx\n   * const { therapists } = await vard.extend(therapistSchema).get();\n   */\n  schema: <S extends VardSchema>(schema: S): VardSchemaFragment<S> =>\n    schema as VardSchemaFragment<S>,\n};\n\n// ─────────────────────────────────────────────\n// Type inference for schema objects\n// ─────────────────────────────────────────────\n\nexport type InferSchema<T> = 0 extends 1 & T\n  ? any\n  : T extends VardField<infer U>\n    ? U\n    : T extends VardCollection<infer S>\n      ? InferSchema<S>[]\n      : T extends VardSchemaFragment<infer S>\n        ? InferSchema<S>\n        : T extends Record<string, any>\n          ? { [K in keyof T as K extends \"__fragment\" ? never : K]: InferSchema<T[K]> }\n          : T;\n"],"mappings":"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","names":["v"]}

package/dist/index.mjs

@@ -2,15 +2,15 @@
 function createVardFetchStore(options = {}) {
   const {
     apiBase = options.apiBase ?? process.env.VARD_API_BASE ?? process.env.NEXT_PUBLIC_VARD_API_BASE ?? "https://dash.vard.app",
-    workspaceId = options.workspaceId ?? process.env.VARD_WORKSPACE_ID,
     apiKey = options.apiKey ?? process.env.VARD_API_KEY,
     fetchOptions = {}
   } = options;
   let resolvedValues = null;
+  let structuredContent = null;
   let fetchPromise = null;
   async function fetchValues() {
     const isDevelopment = process.env.NODE_ENV === "development";
-    if (!apiKey && !workspaceId) {
+    if (!apiKey) {
       if (!isDevelopment) {
         console.error(
           "\x1B[31m[vard] Missing configuration! VARD_API_KEY is not set.\x1B[0m\nPlease set this environment variable in your production environment."
@@ -20,37 +20,51 @@ function createVardFetchStore(options = {}) {
           "[vard] No API Key found. Running in local fallback mode (using default values)."
         );
       }
-      return /* @__PURE__ */ new Map();
+      return { variables: /* @__PURE__ */ new Map(), structured: {} };
     }
-    const url = apiKey ? `${apiBase}/api/content/variables` : `${apiBase}/v1/workspaces/${workspaceId}/variables`;
+    const url = `${apiBase}/api/content/variables?structured=true`;
     try {
       const res = await fetch(url, {
         ...fetchOptions,
         headers: {
           ...fetchOptions.headers,
-          ...apiKey ? { "X-Vard-API-Key": apiKey } : {}
+          "X-Vard-API-Key": apiKey
         }
       });
       if (!res.ok) {
         console.warn(`[vard] Failed to fetch variables: ${res.status}`);
-        return /* @__PURE__ */ new Map();
+        return { variables: /* @__PURE__ */ new Map(), structured: {} };
       }
       const data = await res.json();
-      return new Map(data.map((v) => [v.key, v.value]));
+      if (Array.isArray(data)) {
+        return {
+          variables: new Map(data.map((v2) => [v2.key, v2.value])),
+          structured: {}
+        };
+      }
+      return {
+        variables: new Map(data.variables.map((v2) => [v2.key, v2.value])),
+        structured: data.structured || {}
+      };
     } catch (err) {
-      return /* @__PURE__ */ new Map();
+      return { variables: /* @__PURE__ */ new Map(), structured: {} };
     }
   }
   return {
     get(key) {
       return resolvedValues?.get(key);
     },
+    getStructured() {
+      return structuredContent;
+    },
     async prefetch() {
       if (resolvedValues) return;
       if (!fetchPromise) {
         fetchPromise = fetchValues();
       }
-      resolvedValues = await fetchPromise;
+      const result = await fetchPromise;
+      resolvedValues = result.variables;
+      structuredContent = result.structured;
     }
   };
 }
@@ -69,7 +83,7 @@ var noopStore = {
   }
 };
 function createVard(options = {}) {
-  const store = options.store ?? (options.apiKey || options.workspaceId ? createVardFetchStore(options) : noopStore);
+  const store = options.store ?? (options.apiKey ? createVardFetchStore(options) : noopStore);
   const registry = [];
   function register(def) {
     if (!registry.find((d) => d.key === def.key)) {
@@ -81,7 +95,85 @@ function createVard(options = {}) {
     }
     return def.defaultValue;
   }
+  function flattenSchema(schema, prefix = "") {
+    const result = {};
+    for (const [key, value] of Object.entries(schema)) {
+      const fullKey = prefix ? `${prefix}.${key}` : key;
+      if (typeof value === "object" && value !== null && "type" in value) {
+        const field = value;
+        if (field.type === "collection") {
+          const collection = field;
+          const listItemSchema = {};
+          for (const [fKey, fVal] of Object.entries(collection.schema)) {
+            listItemSchema[fKey] = fVal.type;
+          }
+          register({
+            key: fullKey,
+            label: labelFromKey(key),
+            type: "list",
+            defaultValue: [],
+            editableBy: "member",
+            listItemSchema,
+            isCollection: true
+          });
+          Object.defineProperty(result, key, {
+            get: () => store.get(fullKey) ?? [],
+            enumerable: true
+          });
+        } else {
+          const vardField = field;
+          register({
+            key: fullKey,
+            label: vardField.label ?? labelFromKey(key),
+            description: vardField.description,
+            type: vardField.type,
+            defaultValue: vardField.default,
+            editableBy: vardField.editableBy ?? "member",
+            group: vardField.group
+          });
+          Object.defineProperty(result, key, {
+            get: () => store.get(fullKey) ?? vardField.default,
+            enumerable: true
+          });
+        }
+      } else if (typeof value === "object" && value !== null) {
+        result[key] = flattenSchema(value, fullKey);
+      }
+    }
+    return result;
+  }
+  if (options.schema && process.env.NODE_ENV === "development" && options.apiKey) {
+    flattenSchema(options.schema);
+    const definitions = [...registry];
+    const apiBase = process.env.VARD_API_BASE ?? process.env.NEXT_PUBLIC_VARD_API_BASE ?? "https://dash.vard.app";
+    fetch(`${apiBase}/api/content/variables/sync`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Vard-API-Key": options.apiKey
+      },
+      body: JSON.stringify({
+        definitions,
+        schema: options.schema
+      })
+    }).catch((err) => console.warn("[vard] Auto-sync failed:", err));
+  }
   const client = {
+    define(schema) {
+      return flattenSchema(schema);
+    },
+    async get() {
+      if (store.prefetch) {
+        await store.prefetch();
+      }
+      if (store.getStructured) {
+        const structured = store.getStructured();
+        if (structured && Object.keys(structured).length > 0) {
+          return structured;
+        }
+      }
+      return flattenSchema(options.schema ?? {});
+    },
     string(key, fallback, opts = {}) {
       return register({
         key,
@@ -182,6 +274,14 @@ function createVard(options = {}) {
         return client.list(key, schema, fallback, { ...opts, group: "Global" });
       }
     },
+    extend(fragment) {
+      const mergedSchema = { ...options.schema ?? {}, ...fragment };
+      return createVard({
+        ...options,
+        schema: mergedSchema,
+        store
+      });
+    },
     getDefinitions() {
       return [...registry];
     },
@@ -193,8 +293,56 @@ function labelFromKey(key) {
   const lastSegment = key.split(".").pop() ?? key;
   return lastSegment.replace(/([A-Z])/g, " $1").replace(/^./, (c) => c.toUpperCase()).trim();
 }
+
+// src/schema.ts
+var v = {
+  string: (defaultValue, opts = {}) => ({
+    type: "string",
+    default: defaultValue,
+    ...opts
+  }),
+  richtext: (defaultValue, opts = {}) => ({
+    type: "richtext",
+    default: defaultValue,
+    ...opts
+  }),
+  color: (defaultValue, opts = {}) => ({
+    type: "color",
+    default: defaultValue,
+    ...opts
+  }),
+  image: (defaultValue, opts = {}) => ({
+    type: "image",
+    default: defaultValue,
+    ...opts
+  }),
+  boolean: (defaultValue, opts = {}) => ({
+    type: "boolean",
+    default: defaultValue,
+    ...opts
+  }),
+  collection: (schema) => ({
+    type: "collection",
+    schema
+  }),
+  /**
+   * Creates a reusable schema fragment that can be merged into a Vard client
+   * via `vard.extend(fragment)`. Co-locate this with your page/component.
+   *
+   * @example
+   * // app/therapists/schema.ts
+   * export const therapistSchema = v.schema({
+   *   therapists: v.collection({ name: v.string(), photo: v.image() }),
+   * });
+   *
+   * // app/therapists/page.tsx
+   * const { therapists } = await vard.extend(therapistSchema).get();
+   */
+  schema: (schema) => schema
+};
 export {
   createVard,
-  createVardFetchStore
+  createVardFetchStore,
+  v
 };
 //# sourceMappingURL=index.mjs.map