@studiolayer/client 0.1.0

package/README.md

@@ -0,0 +1,155 @@
+# @studiolayer/client
+
+Typed client for the StudioLayer **content API**. Read and write a project's
+node datasets from any website or app: headless-CMS style, and beyond.
+
+Your site talks to project **nodes** over a small, key-authenticated REST
+surface (`/api/content/*`). A **project API key** (`slk_...`) grants read and/or
+write access to specific nodes and datasets. This package wraps that surface in
+a fully typed client with built-in read caching.
+
+- Zero dependencies, works in Node 18+ and the browser (the API sends permissive CORS).
+- Dual ESM / CommonJS build, full TypeScript types.
+- Read caching with TTL, automatic invalidation on writes, and a `clearCache()` method.
+
+## Install
+
+```bash
+npm install @studiolayer/client
+```
+
+## Quick start
+
+```ts
+import { createClient } from '@studiolayer/client'
+
+const studio = createClient({
+  apiKey: process.env.STUDIOLAYER_API_KEY!, // slk_...
+  baseUrl: 'https://studio.example.com',    // your StudioLayer server
+})
+
+// Discover what this key can reach.
+const { nodes } = await studio.schema()
+
+// List records from a dataset.
+const posts = await studio.listRecords('blog', 'posts')
+
+// Or use the fluent, typed handle.
+interface Post { title: string, slug: string, body: string, published: boolean }
+const blog = studio.dataset<Post>('blog', 'posts')
+
+const all = await blog.list()
+const one = await blog.get('rec_abc123')
+const created = await blog.create({ title: 'Hello', slug: 'hello', body: '...', published: true })
+const updated = await blog.update('rec_abc123', { published: false })
+```
+
+Each record is `{ uid, data, createdAt, updatedAt }`, where `data` is keyed by
+field slug with references (files, referenced records) already inflated.
+
+## Authentication & scopes
+
+Pass the project API key as `apiKey`. A key's reach is the union of its per-node
+scopes (read and/or write, optionally narrowed to specific datasets). Calls
+outside the key's scope throw a `StudioLayerError` with `status` 403; an
+unknown node/dataset/record throws 404.
+
+```ts
+import { StudioLayerError } from '@studiolayer/client'
+
+try {
+  await studio.getRecord('blog', 'posts', 'nope')
+} catch (err) {
+  if (err instanceof StudioLayerError && err.isNotFound) {
+    // handle missing record
+  }
+}
+```
+
+## Introspection
+
+`schema()` returns every node the key can reach, the datasets within, each
+dataset's field schema, and `canRead` / `canWrite` flags so a site can adapt to
+its access without hardcoding slugs.
+
+```ts
+for (const node of await studio.nodes()) {
+  for (const ds of node.datasets) {
+    console.log(node.slug, ds.slug, ds.canWrite ? '(writable)' : '(read-only)')
+  }
+}
+```
+
+## Saved queries
+
+Run a server-defined query (`queries.<slug>`) and get its result. The `shape`
+tells you whether `value` is a `collection`, a `single` record, or a scalar
+`value`.
+
+```ts
+const result = await studio.query('featured-posts')
+if (result.shape === 'collection') {
+  // result.value is an array of records
+}
+```
+
+## Caching
+
+Reads (`schema`, `listRecords`, `getRecord`, `query`) are cached in memory.
+Writes (`createRecord`, `updateRecord`) automatically invalidate the affected
+dataset's cached reads (and all query results, since a query may aggregate it).
+
+```ts
+const studio = createClient({
+  apiKey, baseUrl,
+  cache: { ttl: 30_000, maxEntries: 1000 }, // defaults: ttl 60s, maxEntries 500
+})
+
+// Disable entirely:
+createClient({ apiKey, baseUrl, cache: false })
+
+// Bypass the cache for a single call:
+await studio.listRecords('blog', 'posts', { cache: false })
+```
+
+### Clearing the cache
+
+```ts
+studio.clearCache()                               // everything
+studio.clearCache('blog')                         // one node
+studio.clearCache({ node: 'blog', dataset: 'posts' }) // one dataset
+studio.dataset('blog', 'posts').clearCache()      // same, fluent
+```
+
+Bring your own store (share a cache across instances, or persist it) by
+implementing `CacheStore` and passing it as `cache.store`.
+
+## API
+
+| Method | Description |
+| --- | --- |
+| `schema(opts?)` | Full reachable content shape (`{ nodes }`). |
+| `nodes(opts?)` | Shortcut for `schema().nodes`. |
+| `listRecords<T>(node, dataset, opts?)` | All records in a dataset. |
+| `getRecord<T>(node, dataset, uid, opts?)` | One record by uid. |
+| `createRecord<T>(node, dataset, data)` | Create a record (needs write scope). |
+| `updateRecord<T>(node, dataset, uid, data)` | Merge-patch a record (needs write scope). |
+| `query<V>(slug, opts?)` | Run a saved query. |
+| `dataset<T>(node, dataset)` | Fluent handle: `.list() .get() .create() .update() .clearCache()`. |
+| `clearCache(scope?)` | Clear all, one node, or one dataset. |
+
+`opts` is `{ cache?: boolean }`. All read methods accept a row type parameter
+`<T>` for `record.data`.
+
+## Node < 18
+
+Global `fetch` is required. On older runtimes, pass one:
+
+```ts
+import fetch from 'node-fetch'
+createClient({ apiKey, baseUrl, fetch: fetch as unknown as typeof globalThis.fetch })
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,286 @@
+'use strict';
+
+// src/cache.ts
+var MemoryCacheStore = class {
+  constructor(maxEntries = 500) {
+    this.maxEntries = maxEntries;
+    this.map = /* @__PURE__ */ new Map();
+  }
+  get(key) {
+    return this.map.get(key);
+  }
+  set(key, entry) {
+    this.map.delete(key);
+    this.map.set(key, entry);
+    while (this.map.size > this.maxEntries) {
+      const oldest = this.map.keys().next().value;
+      if (oldest === void 0) break;
+      this.map.delete(oldest);
+    }
+  }
+  delete(key) {
+    this.map.delete(key);
+  }
+  keys() {
+    return this.map.keys();
+  }
+  clear() {
+    this.map.clear();
+  }
+};
+var ContentCache = class {
+  constructor(opts = {}) {
+    this.enabled = opts.enabled ?? true;
+    this.ttl = opts.ttl ?? 6e4;
+    this.store = opts.store ?? new MemoryCacheStore(opts.maxEntries ?? 500);
+  }
+  /** Return a fresh cached value for `key`, or `undefined` on miss/expiry. */
+  get(key, now) {
+    if (!this.enabled) return void 0;
+    const entry = this.store.get(key);
+    if (!entry) return void 0;
+    if (entry.expiresAt !== 0 && entry.expiresAt <= now) {
+      this.store.delete(key);
+      return void 0;
+    }
+    return entry.value;
+  }
+  set(key, value, now) {
+    if (!this.enabled) return;
+    this.store.set(key, { value, expiresAt: this.ttl === 0 ? 0 : now + this.ttl });
+  }
+  /** Drop one exact key. */
+  delete(key) {
+    this.store.delete(key);
+  }
+  /** Drop every key that starts with `prefix`. */
+  deletePrefix(prefix) {
+    for (const key of [...this.store.keys()]) {
+      if (key.startsWith(prefix)) this.store.delete(key);
+    }
+  }
+  clear() {
+    this.store.clear();
+  }
+};
+
+// src/errors.ts
+var StudioLayerError = class _StudioLayerError extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.name = "StudioLayerError";
+    this.status = status;
+    this.body = body;
+    Object.setPrototypeOf(this, _StudioLayerError.prototype);
+  }
+  get isUnauthorized() {
+    return this.status === 401;
+  }
+  get isForbidden() {
+    return this.status === 403;
+  }
+  get isNotFound() {
+    return this.status === 404;
+  }
+};
+
+// src/client.ts
+var StudioLayerClient = class {
+  constructor(options) {
+    if (!options.apiKey) throw new Error("StudioLayerClient: `apiKey` is required");
+    if (!options.baseUrl) throw new Error("StudioLayerClient: `baseUrl` is required");
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    const resolvedFetch = options.fetch ?? globalThis.fetch;
+    if (!resolvedFetch) {
+      throw new Error("StudioLayerClient: no `fetch` available; pass one via options.fetch (Node < 18)");
+    }
+    this.fetchImpl = resolvedFetch.bind(globalThis);
+    this.headers = options.headers ?? {};
+    const cacheOpt = options.cache;
+    this.cache = new ContentCache(
+      cacheOpt === false ? { enabled: false } : cacheOpt === true || cacheOpt === void 0 ? {} : cacheOpt
+    );
+  }
+  // ── Introspection ─────────────────────────────────────────────────────────
+  /** The full content shape this key can reach: nodes, datasets, field schemas. */
+  async schema(opts) {
+    return this.cachedGet("schema", "/schema", opts);
+  }
+  /** Shorthand for `schema()` then `.nodes`. */
+  async nodes(opts) {
+    return (await this.schema(opts)).nodes;
+  }
+  // ── Records ───────────────────────────────────────────────────────────────
+  /** List every record in a dataset (references inflated). Requires read scope. */
+  async listRecords(nodeSlug, datasetSlug, opts) {
+    const res = await this.cachedGet(
+      recordsKey(nodeSlug, datasetSlug),
+      datasetPath(nodeSlug, datasetSlug),
+      opts
+    );
+    return res.records;
+  }
+  /** Read one record by uid. Requires read scope. Throws 404 if it does not exist. */
+  async getRecord(nodeSlug, datasetSlug, recordUid, opts) {
+    const res = await this.cachedGet(
+      recordKey(nodeSlug, datasetSlug, recordUid),
+      `${datasetPath(nodeSlug, datasetSlug)}/${encodeURIComponent(recordUid)}`,
+      opts
+    );
+    return res.record;
+  }
+  /** Create a record. Requires write scope. Invalidates cached reads of the dataset. */
+  async createRecord(nodeSlug, datasetSlug, data) {
+    const res = await this.request(
+      "POST",
+      datasetPath(nodeSlug, datasetSlug),
+      { data }
+    );
+    this.invalidateDataset(nodeSlug, datasetSlug);
+    return res.record;
+  }
+  /**
+   * Partially update a record. The patch is merged onto the stored data (omitted
+   * top-level fields are preserved). Requires write scope. Invalidates cached
+   * reads of the dataset and of this record.
+   */
+  async updateRecord(nodeSlug, datasetSlug, recordUid, data) {
+    const res = await this.request(
+      "PATCH",
+      `${datasetPath(nodeSlug, datasetSlug)}/${encodeURIComponent(recordUid)}`,
+      { data }
+    );
+    this.invalidateDataset(nodeSlug, datasetSlug);
+    this.cache.delete(recordKey(nodeSlug, datasetSlug, recordUid));
+    return res.record;
+  }
+  // -- Queries --
+  /** Run a saved query (`queries.<slug>`) and return its result. Requires read scope. */
+  async query(querySlug, opts) {
+    return this.cachedGet(
+      `query:${querySlug}`,
+      `/queries/${encodeURIComponent(querySlug)}`,
+      opts
+    );
+  }
+  // ── Fluent dataset handle ───────────────────────────────────────────────────
+  /**
+   * A fluent, type-parameterised handle to one dataset:
+   * `client.dataset<Post>('blog', 'posts').list()`.
+   */
+  dataset(nodeSlug, datasetSlug) {
+    return new DatasetHandle(this, nodeSlug, datasetSlug);
+  }
+  // ── Cache control ───────────────────────────────────────────────────────────
+  /**
+   * Clear cached reads. With no argument, clears everything. Pass a scope to
+   * clear just part of it: a node slug, or `{ node, dataset }` for one dataset.
+   */
+  clearCache(scope) {
+    if (scope === void 0) {
+      this.cache.clear();
+      return;
+    }
+    if (typeof scope === "string") {
+      this.cache.deletePrefix(`records:${scope}/`);
+      this.cache.deletePrefix(`record:${scope}/`);
+      return;
+    }
+    if (scope.dataset) {
+      this.invalidateDataset(scope.node, scope.dataset);
+    } else {
+      this.cache.deletePrefix(`records:${scope.node}/`);
+      this.cache.deletePrefix(`record:${scope.node}/`);
+    }
+  }
+  /** Drop cached record reads for a dataset, plus all query results (which may aggregate it). */
+  invalidateDataset(nodeSlug, datasetSlug) {
+    this.cache.delete(recordsKey(nodeSlug, datasetSlug));
+    this.cache.deletePrefix(`${recordKey(nodeSlug, datasetSlug, "")}`);
+    this.cache.deletePrefix("query:");
+  }
+  // ── Transport ───────────────────────────────────────────────────────────────
+  async cachedGet(cacheKey, path, opts) {
+    const useCache = opts?.cache !== false;
+    const now = Date.now();
+    if (useCache) {
+      const hit = this.cache.get(cacheKey, now);
+      if (hit !== void 0) return hit;
+    }
+    const value = await this.request("GET", path);
+    if (useCache) this.cache.set(cacheKey, value, now);
+    return value;
+  }
+  async request(method, path, body) {
+    const res = await this.fetchImpl(`${this.baseUrl}/api/content${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        ...body !== void 0 ? { "Content-Type": "application/json" } : {},
+        ...this.headers
+      },
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    if (!res.ok) {
+      let message = res.statusText || `Request failed with status ${res.status}`;
+      let parsed;
+      try {
+        parsed = await res.json();
+        const m = parsed;
+        if (typeof m?.message === "string") message = m.message;
+        else if (typeof m?.statusMessage === "string") message = m.statusMessage;
+      } catch {
+      }
+      throw new StudioLayerError(message, res.status, parsed);
+    }
+    if (res.status === 204) return void 0;
+    return res.json();
+  }
+};
+var DatasetHandle = class {
+  constructor(client, nodeSlug, datasetSlug) {
+    this.client = client;
+    this.nodeSlug = nodeSlug;
+    this.datasetSlug = datasetSlug;
+  }
+  list(opts) {
+    return this.client.listRecords(this.nodeSlug, this.datasetSlug, opts);
+  }
+  get(recordUid, opts) {
+    return this.client.getRecord(this.nodeSlug, this.datasetSlug, recordUid, opts);
+  }
+  create(data) {
+    return this.client.createRecord(this.nodeSlug, this.datasetSlug, data);
+  }
+  update(recordUid, data) {
+    return this.client.updateRecord(this.nodeSlug, this.datasetSlug, recordUid, data);
+  }
+  /** Clear cached reads for this dataset. */
+  clearCache() {
+    this.client.clearCache({ node: this.nodeSlug, dataset: this.datasetSlug });
+  }
+};
+function datasetPath(nodeSlug, datasetSlug) {
+  return `/nodes/${encodeURIComponent(nodeSlug)}/datasets/${encodeURIComponent(datasetSlug)}/records`;
+}
+function recordsKey(nodeSlug, datasetSlug) {
+  return `records:${nodeSlug}/${datasetSlug}`;
+}
+function recordKey(nodeSlug, datasetSlug, recordUid) {
+  return `record:${nodeSlug}/${datasetSlug}/${recordUid}`;
+}
+
+// src/index.ts
+function createClient(options) {
+  return new StudioLayerClient(options);
+}
+
+exports.ContentCache = ContentCache;
+exports.DatasetHandle = DatasetHandle;
+exports.MemoryCacheStore = MemoryCacheStore;
+exports.StudioLayerClient = StudioLayerClient;
+exports.StudioLayerError = StudioLayerError;
+exports.createClient = createClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts","../src/errors.ts","../src/client.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Read caching for the content client. GET responses (schema, record lists,\n * single records, queries) are cached by request key; writes invalidate the\n * affected keys automatically. Swap in a custom `CacheStore` to share a cache\n * across client instances or to back it with something persistent.\n */\n\nexport interface CacheEntry {\n  value: unknown\n  /** Epoch ms when the entry expires. `0` means it never expires. */\n  expiresAt: number\n}\n\n/** Pluggable backing store. The default is an in-memory, insertion-ordered map. */\nexport interface CacheStore {\n  get(key: string): CacheEntry | undefined\n  set(key: string, entry: CacheEntry): void\n  delete(key: string): void\n  /** Iterate current keys (used for prefix invalidation). */\n  keys(): Iterable<string>\n  clear(): void\n}\n\nexport interface CacheOptions {\n  /** Master switch. Default `true`. */\n  enabled?: boolean\n  /** Time-to-live for cached reads, in ms. Default `60000`. `0` = never expires. */\n  ttl?: number\n  /** Soft cap on entries; oldest are evicted first. Default `500`. */\n  maxEntries?: number\n  /** Custom backing store. Defaults to an in-memory store. */\n  store?: CacheStore\n}\n\n/** In-memory store with insertion-order (FIFO) eviction once `maxEntries` is hit. */\nexport class MemoryCacheStore implements CacheStore {\n  private map = new Map<string, CacheEntry>()\n\n  constructor(private maxEntries = 500) {}\n\n  get(key: string): CacheEntry | undefined {\n    return this.map.get(key)\n  }\n\n  set(key: string, entry: CacheEntry): void {\n    // Re-insert so recently written keys are considered newest.\n    this.map.delete(key)\n    this.map.set(key, entry)\n    while (this.map.size > this.maxEntries) {\n      const oldest = this.map.keys().next().value\n      if (oldest === undefined) break\n      this.map.delete(oldest)\n    }\n  }\n\n  delete(key: string): void {\n    this.map.delete(key)\n  }\n\n  keys(): Iterable<string> {\n    return this.map.keys()\n  }\n\n  clear(): void {\n    this.map.clear()\n  }\n}\n\n/**\n * Thin cache facade the client talks to. Owns TTL logic and prefix-based\n * invalidation so the client only deals in cache keys.\n */\nexport class ContentCache {\n  readonly enabled: boolean\n  private ttl: number\n  private store: CacheStore\n\n  constructor(opts: CacheOptions = {}) {\n    this.enabled = opts.enabled ?? true\n    this.ttl = opts.ttl ?? 60_000\n    this.store = opts.store ?? new MemoryCacheStore(opts.maxEntries ?? 500)\n  }\n\n  /** Return a fresh cached value for `key`, or `undefined` on miss/expiry. */\n  get<T>(key: string, now: number): T | undefined {\n    if (!this.enabled) return undefined\n    const entry = this.store.get(key)\n    if (!entry) return undefined\n    if (entry.expiresAt !== 0 && entry.expiresAt <= now) {\n      this.store.delete(key)\n      return undefined\n    }\n    return entry.value as T\n  }\n\n  set(key: string, value: unknown, now: number): void {\n    if (!this.enabled) return\n    this.store.set(key, { value, expiresAt: this.ttl === 0 ? 0 : now + this.ttl })\n  }\n\n  /** Drop one exact key. */\n  delete(key: string): void {\n    this.store.delete(key)\n  }\n\n  /** Drop every key that starts with `prefix`. */\n  deletePrefix(prefix: string): void {\n    for (const key of [...this.store.keys()]) {\n      if (key.startsWith(prefix)) this.store.delete(key)\n    }\n  }\n\n  clear(): void {\n    this.store.clear()\n  }\n}\n","/**\n * Error thrown for any non-2xx response from the content API. `status` carries\n * the HTTP status code so callers can branch (401 bad key, 403 out of scope,\n * 404 missing node/dataset/record, 422 query failed).\n */\nexport class StudioLayerError extends Error {\n  readonly status: number\n  /** The raw parsed response body, when the server returned one. */\n  readonly body: unknown\n\n  constructor(message: string, status: number, body?: unknown) {\n    super(message)\n    this.name = 'StudioLayerError'\n    this.status = status\n    this.body = body\n    // Restore prototype chain for `instanceof` when transpiled to ES5.\n    Object.setPrototypeOf(this, StudioLayerError.prototype)\n  }\n\n  get isUnauthorized(): boolean {\n    return this.status === 401\n  }\n\n  get isForbidden(): boolean {\n    return this.status === 403\n  }\n\n  get isNotFound(): boolean {\n    return this.status === 404\n  }\n}\n","import { ContentCache, type CacheOptions } from './cache'\nimport { StudioLayerError } from './errors'\nimport type { ContentRecord, ContentSchema, QueryResult, SchemaNode } from './types'\n\nexport interface StudioLayerClientOptions {\n  /**\n   * Project API key, `slk_...`. Mint one in the project's settings under\n   * \"API keys\". Its reach is the union of its per-node read/write scopes.\n   */\n  apiKey: string\n  /**\n   * Base URL of your StudioLayer server, without a trailing `/api/content`\n   * (that path is appended automatically), e.g. `https://studio.example.com`.\n   */\n  baseUrl: string\n  /** Read caching. Pass `false` to disable, or an options object to tune it. */\n  cache?: boolean | CacheOptions\n  /** Custom `fetch` implementation. Defaults to the global `fetch`. */\n  fetch?: typeof fetch\n  /** Extra headers merged into every request. */\n  headers?: Record<string, string>\n}\n\n/** Per-call read options. */\nexport interface ReadOptions {\n  /** Set `false` to bypass the cache for this call and always hit the network. */\n  cache?: boolean\n}\n\ntype Method = 'GET' | 'POST' | 'PATCH'\n\n/**\n * Typed client for the StudioLayer content API: read and write a project's node\n * datasets from any website or app. Reads are cached (see the `cache` option);\n * writes invalidate the affected cache entries automatically.\n *\n * ```ts\n * const studio = new StudioLayerClient({ apiKey: 'slk_...', baseUrl: 'https://studio.example.com' })\n * const posts = await studio.dataset<Post>('blog', 'posts').list()\n * ```\n */\nexport class StudioLayerClient {\n  private readonly apiKey: string\n  private readonly baseUrl: string\n  private readonly fetchImpl: typeof fetch\n  private readonly headers: Record<string, string>\n  private readonly cache: ContentCache\n\n  constructor(options: StudioLayerClientOptions) {\n    if (!options.apiKey) throw new Error('StudioLayerClient: `apiKey` is required')\n    if (!options.baseUrl) throw new Error('StudioLayerClient: `baseUrl` is required')\n\n    this.apiKey = options.apiKey\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, '')\n    const resolvedFetch = options.fetch ?? globalThis.fetch\n    if (!resolvedFetch) {\n      throw new Error('StudioLayerClient: no `fetch` available; pass one via options.fetch (Node < 18)')\n    }\n    this.fetchImpl = resolvedFetch.bind(globalThis)\n    this.headers = options.headers ?? {}\n\n    const cacheOpt = options.cache\n    this.cache = new ContentCache(\n      cacheOpt === false ? { enabled: false }\n        : cacheOpt === true || cacheOpt === undefined ? {}\n          : cacheOpt,\n    )\n  }\n\n  // ── Introspection ─────────────────────────────────────────────────────────\n\n  /** The full content shape this key can reach: nodes, datasets, field schemas. */\n  async schema(opts?: ReadOptions): Promise<ContentSchema> {\n    return this.cachedGet<ContentSchema>('schema', '/schema', opts)\n  }\n\n  /** Shorthand for `schema()` then `.nodes`. */\n  async nodes(opts?: ReadOptions): Promise<SchemaNode[]> {\n    return (await this.schema(opts)).nodes\n  }\n\n  // ── Records ───────────────────────────────────────────────────────────────\n\n  /** List every record in a dataset (references inflated). Requires read scope. */\n  async listRecords<T = Record<string, unknown>>(\n    nodeSlug: string,\n    datasetSlug: string,\n    opts?: ReadOptions,\n  ): Promise<ContentRecord<T>[]> {\n    const res = await this.cachedGet<{ records: ContentRecord<T>[] }>(\n      recordsKey(nodeSlug, datasetSlug),\n      datasetPath(nodeSlug, datasetSlug),\n      opts,\n    )\n    return res.records\n  }\n\n  /** Read one record by uid. Requires read scope. Throws 404 if it does not exist. */\n  async getRecord<T = Record<string, unknown>>(\n    nodeSlug: string,\n    datasetSlug: string,\n    recordUid: string,\n    opts?: ReadOptions,\n  ): Promise<ContentRecord<T>> {\n    const res = await this.cachedGet<{ record: ContentRecord<T> }>(\n      recordKey(nodeSlug, datasetSlug, recordUid),\n      `${datasetPath(nodeSlug, datasetSlug)}/${encodeURIComponent(recordUid)}`,\n      opts,\n    )\n    return res.record\n  }\n\n  /** Create a record. Requires write scope. Invalidates cached reads of the dataset. */\n  async createRecord<T = Record<string, unknown>>(\n    nodeSlug: string,\n    datasetSlug: string,\n    data: Record<string, unknown>,\n  ): Promise<ContentRecord<T>> {\n    const res = await this.request<{ record: ContentRecord<T> }>(\n      'POST',\n      datasetPath(nodeSlug, datasetSlug),\n      { data },\n    )\n    this.invalidateDataset(nodeSlug, datasetSlug)\n    return res.record\n  }\n\n  /**\n   * Partially update a record. The patch is merged onto the stored data (omitted\n   * top-level fields are preserved). Requires write scope. Invalidates cached\n   * reads of the dataset and of this record.\n   */\n  async updateRecord<T = Record<string, unknown>>(\n    nodeSlug: string,\n    datasetSlug: string,\n    recordUid: string,\n    data: Record<string, unknown>,\n  ): Promise<ContentRecord<T>> {\n    const res = await this.request<{ record: ContentRecord<T> }>(\n      'PATCH',\n      `${datasetPath(nodeSlug, datasetSlug)}/${encodeURIComponent(recordUid)}`,\n      { data },\n    )\n    this.invalidateDataset(nodeSlug, datasetSlug)\n    this.cache.delete(recordKey(nodeSlug, datasetSlug, recordUid))\n    return res.record\n  }\n\n  // -- Queries --\n\n  /** Run a saved query (`queries.<slug>`) and return its result. Requires read scope. */\n  async query<V = unknown>(querySlug: string, opts?: ReadOptions): Promise<QueryResult<V>> {\n    return this.cachedGet<QueryResult<V>>(\n      `query:${querySlug}`,\n      `/queries/${encodeURIComponent(querySlug)}`,\n      opts,\n    )\n  }\n\n  // ── Fluent dataset handle ───────────────────────────────────────────────────\n\n  /**\n   * A fluent, type-parameterised handle to one dataset:\n   * `client.dataset<Post>('blog', 'posts').list()`.\n   */\n  dataset<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string): DatasetHandle<T> {\n    return new DatasetHandle<T>(this, nodeSlug, datasetSlug)\n  }\n\n  // ── Cache control ───────────────────────────────────────────────────────────\n\n  /**\n   * Clear cached reads. With no argument, clears everything. Pass a scope to\n   * clear just part of it: a node slug, or `{ node, dataset }` for one dataset.\n   */\n  clearCache(scope?: string | { node: string, dataset?: string }): void {\n    if (scope === undefined) {\n      this.cache.clear()\n      return\n    }\n    if (typeof scope === 'string') {\n      this.cache.deletePrefix(`records:${scope}/`)\n      this.cache.deletePrefix(`record:${scope}/`)\n      return\n    }\n    if (scope.dataset) {\n      this.invalidateDataset(scope.node, scope.dataset)\n    } else {\n      this.cache.deletePrefix(`records:${scope.node}/`)\n      this.cache.deletePrefix(`record:${scope.node}/`)\n    }\n  }\n\n  /** Drop cached record reads for a dataset, plus all query results (which may aggregate it). */\n  private invalidateDataset(nodeSlug: string, datasetSlug: string): void {\n    this.cache.delete(recordsKey(nodeSlug, datasetSlug))\n    this.cache.deletePrefix(`${recordKey(nodeSlug, datasetSlug, '')}`)\n    this.cache.deletePrefix('query:')\n  }\n\n  // ── Transport ───────────────────────────────────────────────────────────────\n\n  private async cachedGet<T>(cacheKey: string, path: string, opts?: ReadOptions): Promise<T> {\n    const useCache = opts?.cache !== false\n    const now = Date.now()\n    if (useCache) {\n      const hit = this.cache.get<T>(cacheKey, now)\n      if (hit !== undefined) return hit\n    }\n    const value = await this.request<T>('GET', path)\n    if (useCache) this.cache.set(cacheKey, value, now)\n    return value\n  }\n\n  private async request<T>(method: Method, path: string, body?: unknown): Promise<T> {\n    const res = await this.fetchImpl(`${this.baseUrl}/api/content${path}`, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n        ...this.headers,\n      },\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    })\n\n    if (!res.ok) {\n      let message = res.statusText || `Request failed with status ${res.status}`\n      let parsed: unknown\n      try {\n        parsed = await res.json()\n        const m = parsed as { message?: unknown, statusMessage?: unknown }\n        if (typeof m?.message === 'string') message = m.message\n        else if (typeof m?.statusMessage === 'string') message = m.statusMessage\n      } catch {\n        /* non-JSON error body; keep the status text */\n      }\n      throw new StudioLayerError(message, res.status, parsed)\n    }\n\n    if (res.status === 204) return undefined as T\n    return res.json() as Promise<T>\n  }\n}\n\n/** Fluent, dataset-scoped view returned by `client.dataset()`. */\nexport class DatasetHandle<T = Record<string, unknown>> {\n  constructor(\n    private readonly client: StudioLayerClient,\n    private readonly nodeSlug: string,\n    private readonly datasetSlug: string,\n  ) {}\n\n  list(opts?: ReadOptions): Promise<ContentRecord<T>[]> {\n    return this.client.listRecords<T>(this.nodeSlug, this.datasetSlug, opts)\n  }\n\n  get(recordUid: string, opts?: ReadOptions): Promise<ContentRecord<T>> {\n    return this.client.getRecord<T>(this.nodeSlug, this.datasetSlug, recordUid, opts)\n  }\n\n  create(data: Record<string, unknown>): Promise<ContentRecord<T>> {\n    return this.client.createRecord<T>(this.nodeSlug, this.datasetSlug, data)\n  }\n\n  update(recordUid: string, data: Record<string, unknown>): Promise<ContentRecord<T>> {\n    return this.client.updateRecord<T>(this.nodeSlug, this.datasetSlug, recordUid, data)\n  }\n\n  /** Clear cached reads for this dataset. */\n  clearCache(): void {\n    this.client.clearCache({ node: this.nodeSlug, dataset: this.datasetSlug })\n  }\n}\n\n// ── Cache-key + path helpers ──────────────────────────────────────────────────\n\nfunction datasetPath(nodeSlug: string, datasetSlug: string): string {\n  return `/nodes/${encodeURIComponent(nodeSlug)}/datasets/${encodeURIComponent(datasetSlug)}/records`\n}\n\nfunction recordsKey(nodeSlug: string, datasetSlug: string): string {\n  return `records:${nodeSlug}/${datasetSlug}`\n}\n\nfunction recordKey(nodeSlug: string, datasetSlug: string, recordUid: string): string {\n  return `record:${nodeSlug}/${datasetSlug}/${recordUid}`\n}\n","export { StudioLayerClient, DatasetHandle } from './client'\nexport type { StudioLayerClientOptions, ReadOptions } from './client'\nexport { StudioLayerError } from './errors'\nexport { ContentCache, MemoryCacheStore } from './cache'\nexport type { CacheOptions, CacheStore, CacheEntry } from './cache'\nexport type {\n  ContentSchema,\n  SchemaNode,\n  SchemaDataset,\n  SchemaField,\n  FieldKind,\n  FieldType,\n  ContentRecord,\n  QueryResult,\n  QueryShape,\n} from './types'\n\nimport { StudioLayerClient, type StudioLayerClientOptions } from './client'\n\n/** Convenience factory: `createClient({ apiKey, baseUrl })`. */\nexport function createClient(options: StudioLayerClientOptions): StudioLayerClient {\n  return new StudioLayerClient(options)\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,230 @@
+/**
+ * Read caching for the content client. GET responses (schema, record lists,
+ * single records, queries) are cached by request key; writes invalidate the
+ * affected keys automatically. Swap in a custom `CacheStore` to share a cache
+ * across client instances or to back it with something persistent.
+ */
+interface CacheEntry {
+    value: unknown;
+    /** Epoch ms when the entry expires. `0` means it never expires. */
+    expiresAt: number;
+}
+/** Pluggable backing store. The default is an in-memory, insertion-ordered map. */
+interface CacheStore {
+    get(key: string): CacheEntry | undefined;
+    set(key: string, entry: CacheEntry): void;
+    delete(key: string): void;
+    /** Iterate current keys (used for prefix invalidation). */
+    keys(): Iterable<string>;
+    clear(): void;
+}
+interface CacheOptions {
+    /** Master switch. Default `true`. */
+    enabled?: boolean;
+    /** Time-to-live for cached reads, in ms. Default `60000`. `0` = never expires. */
+    ttl?: number;
+    /** Soft cap on entries; oldest are evicted first. Default `500`. */
+    maxEntries?: number;
+    /** Custom backing store. Defaults to an in-memory store. */
+    store?: CacheStore;
+}
+/** In-memory store with insertion-order (FIFO) eviction once `maxEntries` is hit. */
+declare class MemoryCacheStore implements CacheStore {
+    private maxEntries;
+    private map;
+    constructor(maxEntries?: number);
+    get(key: string): CacheEntry | undefined;
+    set(key: string, entry: CacheEntry): void;
+    delete(key: string): void;
+    keys(): Iterable<string>;
+    clear(): void;
+}
+/**
+ * Thin cache facade the client talks to. Owns TTL logic and prefix-based
+ * invalidation so the client only deals in cache keys.
+ */
+declare class ContentCache {
+    readonly enabled: boolean;
+    private ttl;
+    private store;
+    constructor(opts?: CacheOptions);
+    /** Return a fresh cached value for `key`, or `undefined` on miss/expiry. */
+    get<T>(key: string, now: number): T | undefined;
+    set(key: string, value: unknown, now: number): void;
+    /** Drop one exact key. */
+    delete(key: string): void;
+    /** Drop every key that starts with `prefix`. */
+    deletePrefix(prefix: string): void;
+    clear(): void;
+}
+
+/**
+ * Wire types for the StudioLayer content API. These mirror the server DTOs
+ * (`server/utils/content/*`, `server/api/content/*`) one-to-one. Slugs are used
+ * on the wire; internal database ids never leak.
+ */
+/** Top-level shape category of a dataset field. */
+type FieldKind = 'primitive' | 'object' | 'collection' | 'reference';
+/** The primitive field types the platform ships. `reference` and `''` also occur. */
+type FieldType = 'text' | 'textarea' | 'number' | 'boolean' | 'color' | 'date' | 'email' | 'file' | 'image' | 'identifier' | 'json' | 'select' | 'url' | 'reference' | '';
+/** One field in a dataset's schema, as returned by `GET /schema`. */
+interface SchemaField {
+    slug: string;
+    label: string;
+    kind: FieldKind;
+    type: FieldType;
+    required: boolean;
+    description: string | null;
+}
+/** A dataset reachable by the key, with its field schema and this key's access. */
+interface SchemaDataset {
+    slug: string;
+    name: string;
+    description: string | null;
+    type: string;
+    /** Whether the key may read records from this dataset. */
+    canRead: boolean;
+    /** Whether the key may create/update records in this dataset. */
+    canWrite: boolean;
+    fields: SchemaField[];
+}
+/** A node reachable by the key, with the datasets it exposes. */
+interface SchemaNode {
+    slug: string;
+    name: string;
+    description: string | null;
+    datasets: SchemaDataset[];
+}
+/** Response of `GET /schema`: the full content shape this key can reach. */
+interface ContentSchema {
+    nodes: SchemaNode[];
+}
+/**
+ * A single content record. `data` holds the field values keyed by field slug,
+ * with references already inflated (file URLs, referenced-record snapshots).
+ * Parameterise it with your own row type for full type safety.
+ */
+interface ContentRecord<T = Record<string, unknown>> {
+    uid: string;
+    data: T;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Result shape of a saved query, mirroring the query engine. */
+type QueryShape = 'collection' | 'single' | 'value';
+/** Response of `GET /queries/:slug`. `value` type depends on `shape`. */
+interface QueryResult<V = unknown> {
+    query: string;
+    shape: QueryShape;
+    value: V;
+}
+
+interface StudioLayerClientOptions {
+    /**
+     * Project API key, `slk_...`. Mint one in the project's settings under
+     * "API keys". Its reach is the union of its per-node read/write scopes.
+     */
+    apiKey: string;
+    /**
+     * Base URL of your StudioLayer server, without a trailing `/api/content`
+     * (that path is appended automatically), e.g. `https://studio.example.com`.
+     */
+    baseUrl: string;
+    /** Read caching. Pass `false` to disable, or an options object to tune it. */
+    cache?: boolean | CacheOptions;
+    /** Custom `fetch` implementation. Defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+    /** Extra headers merged into every request. */
+    headers?: Record<string, string>;
+}
+/** Per-call read options. */
+interface ReadOptions {
+    /** Set `false` to bypass the cache for this call and always hit the network. */
+    cache?: boolean;
+}
+/**
+ * Typed client for the StudioLayer content API: read and write a project's node
+ * datasets from any website or app. Reads are cached (see the `cache` option);
+ * writes invalidate the affected cache entries automatically.
+ *
+ * ```ts
+ * const studio = new StudioLayerClient({ apiKey: 'slk_...', baseUrl: 'https://studio.example.com' })
+ * const posts = await studio.dataset<Post>('blog', 'posts').list()
+ * ```
+ */
+declare class StudioLayerClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly headers;
+    private readonly cache;
+    constructor(options: StudioLayerClientOptions);
+    /** The full content shape this key can reach: nodes, datasets, field schemas. */
+    schema(opts?: ReadOptions): Promise<ContentSchema>;
+    /** Shorthand for `schema()` then `.nodes`. */
+    nodes(opts?: ReadOptions): Promise<SchemaNode[]>;
+    /** List every record in a dataset (references inflated). Requires read scope. */
+    listRecords<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string, opts?: ReadOptions): Promise<ContentRecord<T>[]>;
+    /** Read one record by uid. Requires read scope. Throws 404 if it does not exist. */
+    getRecord<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string, recordUid: string, opts?: ReadOptions): Promise<ContentRecord<T>>;
+    /** Create a record. Requires write scope. Invalidates cached reads of the dataset. */
+    createRecord<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string, data: Record<string, unknown>): Promise<ContentRecord<T>>;
+    /**
+     * Partially update a record. The patch is merged onto the stored data (omitted
+     * top-level fields are preserved). Requires write scope. Invalidates cached
+     * reads of the dataset and of this record.
+     */
+    updateRecord<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string, recordUid: string, data: Record<string, unknown>): Promise<ContentRecord<T>>;
+    /** Run a saved query (`queries.<slug>`) and return its result. Requires read scope. */
+    query<V = unknown>(querySlug: string, opts?: ReadOptions): Promise<QueryResult<V>>;
+    /**
+     * A fluent, type-parameterised handle to one dataset:
+     * `client.dataset<Post>('blog', 'posts').list()`.
+     */
+    dataset<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string): DatasetHandle<T>;
+    /**
+     * Clear cached reads. With no argument, clears everything. Pass a scope to
+     * clear just part of it: a node slug, or `{ node, dataset }` for one dataset.
+     */
+    clearCache(scope?: string | {
+        node: string;
+        dataset?: string;
+    }): void;
+    /** Drop cached record reads for a dataset, plus all query results (which may aggregate it). */
+    private invalidateDataset;
+    private cachedGet;
+    private request;
+}
+/** Fluent, dataset-scoped view returned by `client.dataset()`. */
+declare class DatasetHandle<T = Record<string, unknown>> {
+    private readonly client;
+    private readonly nodeSlug;
+    private readonly datasetSlug;
+    constructor(client: StudioLayerClient, nodeSlug: string, datasetSlug: string);
+    list(opts?: ReadOptions): Promise<ContentRecord<T>[]>;
+    get(recordUid: string, opts?: ReadOptions): Promise<ContentRecord<T>>;
+    create(data: Record<string, unknown>): Promise<ContentRecord<T>>;
+    update(recordUid: string, data: Record<string, unknown>): Promise<ContentRecord<T>>;
+    /** Clear cached reads for this dataset. */
+    clearCache(): void;
+}
+
+/**
+ * Error thrown for any non-2xx response from the content API. `status` carries
+ * the HTTP status code so callers can branch (401 bad key, 403 out of scope,
+ * 404 missing node/dataset/record, 422 query failed).
+ */
+declare class StudioLayerError extends Error {
+    readonly status: number;
+    /** The raw parsed response body, when the server returned one. */
+    readonly body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+    get isUnauthorized(): boolean;
+    get isForbidden(): boolean;
+    get isNotFound(): boolean;
+}
+
+/** Convenience factory: `createClient({ apiKey, baseUrl })`. */
+declare function createClient(options: StudioLayerClientOptions): StudioLayerClient;
+
+export { type CacheEntry, type CacheOptions, type CacheStore, ContentCache, type ContentRecord, type ContentSchema, DatasetHandle, type FieldKind, type FieldType, MemoryCacheStore, type QueryResult, type QueryShape, type ReadOptions, type SchemaDataset, type SchemaField, type SchemaNode, StudioLayerClient, type StudioLayerClientOptions, StudioLayerError, createClient };

package/dist/index.d.ts

@@ -0,0 +1,230 @@
+/**
+ * Read caching for the content client. GET responses (schema, record lists,
+ * single records, queries) are cached by request key; writes invalidate the
+ * affected keys automatically. Swap in a custom `CacheStore` to share a cache
+ * across client instances or to back it with something persistent.
+ */
+interface CacheEntry {
+    value: unknown;
+    /** Epoch ms when the entry expires. `0` means it never expires. */
+    expiresAt: number;
+}
+/** Pluggable backing store. The default is an in-memory, insertion-ordered map. */
+interface CacheStore {
+    get(key: string): CacheEntry | undefined;
+    set(key: string, entry: CacheEntry): void;
+    delete(key: string): void;
+    /** Iterate current keys (used for prefix invalidation). */
+    keys(): Iterable<string>;
+    clear(): void;
+}
+interface CacheOptions {
+    /** Master switch. Default `true`. */
+    enabled?: boolean;
+    /** Time-to-live for cached reads, in ms. Default `60000`. `0` = never expires. */
+    ttl?: number;
+    /** Soft cap on entries; oldest are evicted first. Default `500`. */
+    maxEntries?: number;
+    /** Custom backing store. Defaults to an in-memory store. */
+    store?: CacheStore;
+}
+/** In-memory store with insertion-order (FIFO) eviction once `maxEntries` is hit. */
+declare class MemoryCacheStore implements CacheStore {
+    private maxEntries;
+    private map;
+    constructor(maxEntries?: number);
+    get(key: string): CacheEntry | undefined;
+    set(key: string, entry: CacheEntry): void;
+    delete(key: string): void;
+    keys(): Iterable<string>;
+    clear(): void;
+}
+/**
+ * Thin cache facade the client talks to. Owns TTL logic and prefix-based
+ * invalidation so the client only deals in cache keys.
+ */
+declare class ContentCache {
+    readonly enabled: boolean;
+    private ttl;
+    private store;
+    constructor(opts?: CacheOptions);
+    /** Return a fresh cached value for `key`, or `undefined` on miss/expiry. */
+    get<T>(key: string, now: number): T | undefined;
+    set(key: string, value: unknown, now: number): void;
+    /** Drop one exact key. */
+    delete(key: string): void;
+    /** Drop every key that starts with `prefix`. */
+    deletePrefix(prefix: string): void;
+    clear(): void;
+}
+
+/**
+ * Wire types for the StudioLayer content API. These mirror the server DTOs
+ * (`server/utils/content/*`, `server/api/content/*`) one-to-one. Slugs are used
+ * on the wire; internal database ids never leak.
+ */
+/** Top-level shape category of a dataset field. */
+type FieldKind = 'primitive' | 'object' | 'collection' | 'reference';
+/** The primitive field types the platform ships. `reference` and `''` also occur. */
+type FieldType = 'text' | 'textarea' | 'number' | 'boolean' | 'color' | 'date' | 'email' | 'file' | 'image' | 'identifier' | 'json' | 'select' | 'url' | 'reference' | '';
+/** One field in a dataset's schema, as returned by `GET /schema`. */
+interface SchemaField {
+    slug: string;
+    label: string;
+    kind: FieldKind;
+    type: FieldType;
+    required: boolean;
+    description: string | null;
+}
+/** A dataset reachable by the key, with its field schema and this key's access. */
+interface SchemaDataset {
+    slug: string;
+    name: string;
+    description: string | null;
+    type: string;
+    /** Whether the key may read records from this dataset. */
+    canRead: boolean;
+    /** Whether the key may create/update records in this dataset. */
+    canWrite: boolean;
+    fields: SchemaField[];
+}
+/** A node reachable by the key, with the datasets it exposes. */
+interface SchemaNode {
+    slug: string;
+    name: string;
+    description: string | null;
+    datasets: SchemaDataset[];
+}
+/** Response of `GET /schema`: the full content shape this key can reach. */
+interface ContentSchema {
+    nodes: SchemaNode[];
+}
+/**
+ * A single content record. `data` holds the field values keyed by field slug,
+ * with references already inflated (file URLs, referenced-record snapshots).
+ * Parameterise it with your own row type for full type safety.
+ */
+interface ContentRecord<T = Record<string, unknown>> {
+    uid: string;
+    data: T;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Result shape of a saved query, mirroring the query engine. */
+type QueryShape = 'collection' | 'single' | 'value';
+/** Response of `GET /queries/:slug`. `value` type depends on `shape`. */
+interface QueryResult<V = unknown> {
+    query: string;
+    shape: QueryShape;
+    value: V;
+}
+
+interface StudioLayerClientOptions {
+    /**
+     * Project API key, `slk_...`. Mint one in the project's settings under
+     * "API keys". Its reach is the union of its per-node read/write scopes.
+     */
+    apiKey: string;
+    /**
+     * Base URL of your StudioLayer server, without a trailing `/api/content`
+     * (that path is appended automatically), e.g. `https://studio.example.com`.
+     */
+    baseUrl: string;
+    /** Read caching. Pass `false` to disable, or an options object to tune it. */
+    cache?: boolean | CacheOptions;
+    /** Custom `fetch` implementation. Defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+    /** Extra headers merged into every request. */
+    headers?: Record<string, string>;
+}
+/** Per-call read options. */
+interface ReadOptions {
+    /** Set `false` to bypass the cache for this call and always hit the network. */
+    cache?: boolean;
+}
+/**
+ * Typed client for the StudioLayer content API: read and write a project's node
+ * datasets from any website or app. Reads are cached (see the `cache` option);
+ * writes invalidate the affected cache entries automatically.
+ *
+ * ```ts
+ * const studio = new StudioLayerClient({ apiKey: 'slk_...', baseUrl: 'https://studio.example.com' })
+ * const posts = await studio.dataset<Post>('blog', 'posts').list()
+ * ```
+ */
+declare class StudioLayerClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly headers;
+    private readonly cache;
+    constructor(options: StudioLayerClientOptions);
+    /** The full content shape this key can reach: nodes, datasets, field schemas. */
+    schema(opts?: ReadOptions): Promise<ContentSchema>;
+    /** Shorthand for `schema()` then `.nodes`. */
+    nodes(opts?: ReadOptions): Promise<SchemaNode[]>;
+    /** List every record in a dataset (references inflated). Requires read scope. */
+    listRecords<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string, opts?: ReadOptions): Promise<ContentRecord<T>[]>;
+    /** Read one record by uid. Requires read scope. Throws 404 if it does not exist. */
+    getRecord<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string, recordUid: string, opts?: ReadOptions): Promise<ContentRecord<T>>;
+    /** Create a record. Requires write scope. Invalidates cached reads of the dataset. */
+    createRecord<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string, data: Record<string, unknown>): Promise<ContentRecord<T>>;
+    /**
+     * Partially update a record. The patch is merged onto the stored data (omitted
+     * top-level fields are preserved). Requires write scope. Invalidates cached
+     * reads of the dataset and of this record.
+     */
+    updateRecord<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string, recordUid: string, data: Record<string, unknown>): Promise<ContentRecord<T>>;
+    /** Run a saved query (`queries.<slug>`) and return its result. Requires read scope. */
+    query<V = unknown>(querySlug: string, opts?: ReadOptions): Promise<QueryResult<V>>;
+    /**
+     * A fluent, type-parameterised handle to one dataset:
+     * `client.dataset<Post>('blog', 'posts').list()`.
+     */
+    dataset<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string): DatasetHandle<T>;
+    /**
+     * Clear cached reads. With no argument, clears everything. Pass a scope to
+     * clear just part of it: a node slug, or `{ node, dataset }` for one dataset.
+     */
+    clearCache(scope?: string | {
+        node: string;
+        dataset?: string;
+    }): void;
+    /** Drop cached record reads for a dataset, plus all query results (which may aggregate it). */
+    private invalidateDataset;
+    private cachedGet;
+    private request;
+}
+/** Fluent, dataset-scoped view returned by `client.dataset()`. */
+declare class DatasetHandle<T = Record<string, unknown>> {
+    private readonly client;
+    private readonly nodeSlug;
+    private readonly datasetSlug;
+    constructor(client: StudioLayerClient, nodeSlug: string, datasetSlug: string);
+    list(opts?: ReadOptions): Promise<ContentRecord<T>[]>;
+    get(recordUid: string, opts?: ReadOptions): Promise<ContentRecord<T>>;
+    create(data: Record<string, unknown>): Promise<ContentRecord<T>>;
+    update(recordUid: string, data: Record<string, unknown>): Promise<ContentRecord<T>>;
+    /** Clear cached reads for this dataset. */
+    clearCache(): void;
+}
+
+/**
+ * Error thrown for any non-2xx response from the content API. `status` carries
+ * the HTTP status code so callers can branch (401 bad key, 403 out of scope,
+ * 404 missing node/dataset/record, 422 query failed).
+ */
+declare class StudioLayerError extends Error {
+    readonly status: number;
+    /** The raw parsed response body, when the server returned one. */
+    readonly body: unknown;
+    constructor(message: string, status: number, body?: unknown);
+    get isUnauthorized(): boolean;
+    get isForbidden(): boolean;
+    get isNotFound(): boolean;
+}
+
+/** Convenience factory: `createClient({ apiKey, baseUrl })`. */
+declare function createClient(options: StudioLayerClientOptions): StudioLayerClient;
+
+export { type CacheEntry, type CacheOptions, type CacheStore, ContentCache, type ContentRecord, type ContentSchema, DatasetHandle, type FieldKind, type FieldType, MemoryCacheStore, type QueryResult, type QueryShape, type ReadOptions, type SchemaDataset, type SchemaField, type SchemaNode, StudioLayerClient, type StudioLayerClientOptions, StudioLayerError, createClient };

package/dist/index.js

@@ -0,0 +1,279 @@
+// src/cache.ts
+var MemoryCacheStore = class {
+  constructor(maxEntries = 500) {
+    this.maxEntries = maxEntries;
+    this.map = /* @__PURE__ */ new Map();
+  }
+  get(key) {
+    return this.map.get(key);
+  }
+  set(key, entry) {
+    this.map.delete(key);
+    this.map.set(key, entry);
+    while (this.map.size > this.maxEntries) {
+      const oldest = this.map.keys().next().value;
+      if (oldest === void 0) break;
+      this.map.delete(oldest);
+    }
+  }
+  delete(key) {
+    this.map.delete(key);
+  }
+  keys() {
+    return this.map.keys();
+  }
+  clear() {
+    this.map.clear();
+  }
+};
+var ContentCache = class {
+  constructor(opts = {}) {
+    this.enabled = opts.enabled ?? true;
+    this.ttl = opts.ttl ?? 6e4;
+    this.store = opts.store ?? new MemoryCacheStore(opts.maxEntries ?? 500);
+  }
+  /** Return a fresh cached value for `key`, or `undefined` on miss/expiry. */
+  get(key, now) {
+    if (!this.enabled) return void 0;
+    const entry = this.store.get(key);
+    if (!entry) return void 0;
+    if (entry.expiresAt !== 0 && entry.expiresAt <= now) {
+      this.store.delete(key);
+      return void 0;
+    }
+    return entry.value;
+  }
+  set(key, value, now) {
+    if (!this.enabled) return;
+    this.store.set(key, { value, expiresAt: this.ttl === 0 ? 0 : now + this.ttl });
+  }
+  /** Drop one exact key. */
+  delete(key) {
+    this.store.delete(key);
+  }
+  /** Drop every key that starts with `prefix`. */
+  deletePrefix(prefix) {
+    for (const key of [...this.store.keys()]) {
+      if (key.startsWith(prefix)) this.store.delete(key);
+    }
+  }
+  clear() {
+    this.store.clear();
+  }
+};
+
+// src/errors.ts
+var StudioLayerError = class _StudioLayerError extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.name = "StudioLayerError";
+    this.status = status;
+    this.body = body;
+    Object.setPrototypeOf(this, _StudioLayerError.prototype);
+  }
+  get isUnauthorized() {
+    return this.status === 401;
+  }
+  get isForbidden() {
+    return this.status === 403;
+  }
+  get isNotFound() {
+    return this.status === 404;
+  }
+};
+
+// src/client.ts
+var StudioLayerClient = class {
+  constructor(options) {
+    if (!options.apiKey) throw new Error("StudioLayerClient: `apiKey` is required");
+    if (!options.baseUrl) throw new Error("StudioLayerClient: `baseUrl` is required");
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    const resolvedFetch = options.fetch ?? globalThis.fetch;
+    if (!resolvedFetch) {
+      throw new Error("StudioLayerClient: no `fetch` available; pass one via options.fetch (Node < 18)");
+    }
+    this.fetchImpl = resolvedFetch.bind(globalThis);
+    this.headers = options.headers ?? {};
+    const cacheOpt = options.cache;
+    this.cache = new ContentCache(
+      cacheOpt === false ? { enabled: false } : cacheOpt === true || cacheOpt === void 0 ? {} : cacheOpt
+    );
+  }
+  // ── Introspection ─────────────────────────────────────────────────────────
+  /** The full content shape this key can reach: nodes, datasets, field schemas. */
+  async schema(opts) {
+    return this.cachedGet("schema", "/schema", opts);
+  }
+  /** Shorthand for `schema()` then `.nodes`. */
+  async nodes(opts) {
+    return (await this.schema(opts)).nodes;
+  }
+  // ── Records ───────────────────────────────────────────────────────────────
+  /** List every record in a dataset (references inflated). Requires read scope. */
+  async listRecords(nodeSlug, datasetSlug, opts) {
+    const res = await this.cachedGet(
+      recordsKey(nodeSlug, datasetSlug),
+      datasetPath(nodeSlug, datasetSlug),
+      opts
+    );
+    return res.records;
+  }
+  /** Read one record by uid. Requires read scope. Throws 404 if it does not exist. */
+  async getRecord(nodeSlug, datasetSlug, recordUid, opts) {
+    const res = await this.cachedGet(
+      recordKey(nodeSlug, datasetSlug, recordUid),
+      `${datasetPath(nodeSlug, datasetSlug)}/${encodeURIComponent(recordUid)}`,
+      opts
+    );
+    return res.record;
+  }
+  /** Create a record. Requires write scope. Invalidates cached reads of the dataset. */
+  async createRecord(nodeSlug, datasetSlug, data) {
+    const res = await this.request(
+      "POST",
+      datasetPath(nodeSlug, datasetSlug),
+      { data }
+    );
+    this.invalidateDataset(nodeSlug, datasetSlug);
+    return res.record;
+  }
+  /**
+   * Partially update a record. The patch is merged onto the stored data (omitted
+   * top-level fields are preserved). Requires write scope. Invalidates cached
+   * reads of the dataset and of this record.
+   */
+  async updateRecord(nodeSlug, datasetSlug, recordUid, data) {
+    const res = await this.request(
+      "PATCH",
+      `${datasetPath(nodeSlug, datasetSlug)}/${encodeURIComponent(recordUid)}`,
+      { data }
+    );
+    this.invalidateDataset(nodeSlug, datasetSlug);
+    this.cache.delete(recordKey(nodeSlug, datasetSlug, recordUid));
+    return res.record;
+  }
+  // -- Queries --
+  /** Run a saved query (`queries.<slug>`) and return its result. Requires read scope. */
+  async query(querySlug, opts) {
+    return this.cachedGet(
+      `query:${querySlug}`,
+      `/queries/${encodeURIComponent(querySlug)}`,
+      opts
+    );
+  }
+  // ── Fluent dataset handle ───────────────────────────────────────────────────
+  /**
+   * A fluent, type-parameterised handle to one dataset:
+   * `client.dataset<Post>('blog', 'posts').list()`.
+   */
+  dataset(nodeSlug, datasetSlug) {
+    return new DatasetHandle(this, nodeSlug, datasetSlug);
+  }
+  // ── Cache control ───────────────────────────────────────────────────────────
+  /**
+   * Clear cached reads. With no argument, clears everything. Pass a scope to
+   * clear just part of it: a node slug, or `{ node, dataset }` for one dataset.
+   */
+  clearCache(scope) {
+    if (scope === void 0) {
+      this.cache.clear();
+      return;
+    }
+    if (typeof scope === "string") {
+      this.cache.deletePrefix(`records:${scope}/`);
+      this.cache.deletePrefix(`record:${scope}/`);
+      return;
+    }
+    if (scope.dataset) {
+      this.invalidateDataset(scope.node, scope.dataset);
+    } else {
+      this.cache.deletePrefix(`records:${scope.node}/`);
+      this.cache.deletePrefix(`record:${scope.node}/`);
+    }
+  }
+  /** Drop cached record reads for a dataset, plus all query results (which may aggregate it). */
+  invalidateDataset(nodeSlug, datasetSlug) {
+    this.cache.delete(recordsKey(nodeSlug, datasetSlug));
+    this.cache.deletePrefix(`${recordKey(nodeSlug, datasetSlug, "")}`);
+    this.cache.deletePrefix("query:");
+  }
+  // ── Transport ───────────────────────────────────────────────────────────────
+  async cachedGet(cacheKey, path, opts) {
+    const useCache = opts?.cache !== false;
+    const now = Date.now();
+    if (useCache) {
+      const hit = this.cache.get(cacheKey, now);
+      if (hit !== void 0) return hit;
+    }
+    const value = await this.request("GET", path);
+    if (useCache) this.cache.set(cacheKey, value, now);
+    return value;
+  }
+  async request(method, path, body) {
+    const res = await this.fetchImpl(`${this.baseUrl}/api/content${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        ...body !== void 0 ? { "Content-Type": "application/json" } : {},
+        ...this.headers
+      },
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    if (!res.ok) {
+      let message = res.statusText || `Request failed with status ${res.status}`;
+      let parsed;
+      try {
+        parsed = await res.json();
+        const m = parsed;
+        if (typeof m?.message === "string") message = m.message;
+        else if (typeof m?.statusMessage === "string") message = m.statusMessage;
+      } catch {
+      }
+      throw new StudioLayerError(message, res.status, parsed);
+    }
+    if (res.status === 204) return void 0;
+    return res.json();
+  }
+};
+var DatasetHandle = class {
+  constructor(client, nodeSlug, datasetSlug) {
+    this.client = client;
+    this.nodeSlug = nodeSlug;
+    this.datasetSlug = datasetSlug;
+  }
+  list(opts) {
+    return this.client.listRecords(this.nodeSlug, this.datasetSlug, opts);
+  }
+  get(recordUid, opts) {
+    return this.client.getRecord(this.nodeSlug, this.datasetSlug, recordUid, opts);
+  }
+  create(data) {
+    return this.client.createRecord(this.nodeSlug, this.datasetSlug, data);
+  }
+  update(recordUid, data) {
+    return this.client.updateRecord(this.nodeSlug, this.datasetSlug, recordUid, data);
+  }
+  /** Clear cached reads for this dataset. */
+  clearCache() {
+    this.client.clearCache({ node: this.nodeSlug, dataset: this.datasetSlug });
+  }
+};
+function datasetPath(nodeSlug, datasetSlug) {
+  return `/nodes/${encodeURIComponent(nodeSlug)}/datasets/${encodeURIComponent(datasetSlug)}/records`;
+}
+function recordsKey(nodeSlug, datasetSlug) {
+  return `records:${nodeSlug}/${datasetSlug}`;
+}
+function recordKey(nodeSlug, datasetSlug, recordUid) {
+  return `record:${nodeSlug}/${datasetSlug}/${recordUid}`;
+}
+
+// src/index.ts
+function createClient(options) {
+  return new StudioLayerClient(options);
+}
+
+export { ContentCache, DatasetHandle, MemoryCacheStore, StudioLayerClient, StudioLayerError, createClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts","../src/errors.ts","../src/client.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Read caching for the content client. GET responses (schema, record lists,\n * single records, queries) are cached by request key; writes invalidate the\n * affected keys automatically. Swap in a custom `CacheStore` to share a cache\n * across client instances or to back it with something persistent.\n */\n\nexport interface CacheEntry {\n  value: unknown\n  /** Epoch ms when the entry expires. `0` means it never expires. */\n  expiresAt: number\n}\n\n/** Pluggable backing store. The default is an in-memory, insertion-ordered map. */\nexport interface CacheStore {\n  get(key: string): CacheEntry | undefined\n  set(key: string, entry: CacheEntry): void\n  delete(key: string): void\n  /** Iterate current keys (used for prefix invalidation). */\n  keys(): Iterable<string>\n  clear(): void\n}\n\nexport interface CacheOptions {\n  /** Master switch. Default `true`. */\n  enabled?: boolean\n  /** Time-to-live for cached reads, in ms. Default `60000`. `0` = never expires. */\n  ttl?: number\n  /** Soft cap on entries; oldest are evicted first. Default `500`. */\n  maxEntries?: number\n  /** Custom backing store. Defaults to an in-memory store. */\n  store?: CacheStore\n}\n\n/** In-memory store with insertion-order (FIFO) eviction once `maxEntries` is hit. */\nexport class MemoryCacheStore implements CacheStore {\n  private map = new Map<string, CacheEntry>()\n\n  constructor(private maxEntries = 500) {}\n\n  get(key: string): CacheEntry | undefined {\n    return this.map.get(key)\n  }\n\n  set(key: string, entry: CacheEntry): void {\n    // Re-insert so recently written keys are considered newest.\n    this.map.delete(key)\n    this.map.set(key, entry)\n    while (this.map.size > this.maxEntries) {\n      const oldest = this.map.keys().next().value\n      if (oldest === undefined) break\n      this.map.delete(oldest)\n    }\n  }\n\n  delete(key: string): void {\n    this.map.delete(key)\n  }\n\n  keys(): Iterable<string> {\n    return this.map.keys()\n  }\n\n  clear(): void {\n    this.map.clear()\n  }\n}\n\n/**\n * Thin cache facade the client talks to. Owns TTL logic and prefix-based\n * invalidation so the client only deals in cache keys.\n */\nexport class ContentCache {\n  readonly enabled: boolean\n  private ttl: number\n  private store: CacheStore\n\n  constructor(opts: CacheOptions = {}) {\n    this.enabled = opts.enabled ?? true\n    this.ttl = opts.ttl ?? 60_000\n    this.store = opts.store ?? new MemoryCacheStore(opts.maxEntries ?? 500)\n  }\n\n  /** Return a fresh cached value for `key`, or `undefined` on miss/expiry. */\n  get<T>(key: string, now: number): T | undefined {\n    if (!this.enabled) return undefined\n    const entry = this.store.get(key)\n    if (!entry) return undefined\n    if (entry.expiresAt !== 0 && entry.expiresAt <= now) {\n      this.store.delete(key)\n      return undefined\n    }\n    return entry.value as T\n  }\n\n  set(key: string, value: unknown, now: number): void {\n    if (!this.enabled) return\n    this.store.set(key, { value, expiresAt: this.ttl === 0 ? 0 : now + this.ttl })\n  }\n\n  /** Drop one exact key. */\n  delete(key: string): void {\n    this.store.delete(key)\n  }\n\n  /** Drop every key that starts with `prefix`. */\n  deletePrefix(prefix: string): void {\n    for (const key of [...this.store.keys()]) {\n      if (key.startsWith(prefix)) this.store.delete(key)\n    }\n  }\n\n  clear(): void {\n    this.store.clear()\n  }\n}\n","/**\n * Error thrown for any non-2xx response from the content API. `status` carries\n * the HTTP status code so callers can branch (401 bad key, 403 out of scope,\n * 404 missing node/dataset/record, 422 query failed).\n */\nexport class StudioLayerError extends Error {\n  readonly status: number\n  /** The raw parsed response body, when the server returned one. */\n  readonly body: unknown\n\n  constructor(message: string, status: number, body?: unknown) {\n    super(message)\n    this.name = 'StudioLayerError'\n    this.status = status\n    this.body = body\n    // Restore prototype chain for `instanceof` when transpiled to ES5.\n    Object.setPrototypeOf(this, StudioLayerError.prototype)\n  }\n\n  get isUnauthorized(): boolean {\n    return this.status === 401\n  }\n\n  get isForbidden(): boolean {\n    return this.status === 403\n  }\n\n  get isNotFound(): boolean {\n    return this.status === 404\n  }\n}\n","import { ContentCache, type CacheOptions } from './cache'\nimport { StudioLayerError } from './errors'\nimport type { ContentRecord, ContentSchema, QueryResult, SchemaNode } from './types'\n\nexport interface StudioLayerClientOptions {\n  /**\n   * Project API key, `slk_...`. Mint one in the project's settings under\n   * \"API keys\". Its reach is the union of its per-node read/write scopes.\n   */\n  apiKey: string\n  /**\n   * Base URL of your StudioLayer server, without a trailing `/api/content`\n   * (that path is appended automatically), e.g. `https://studio.example.com`.\n   */\n  baseUrl: string\n  /** Read caching. Pass `false` to disable, or an options object to tune it. */\n  cache?: boolean | CacheOptions\n  /** Custom `fetch` implementation. Defaults to the global `fetch`. */\n  fetch?: typeof fetch\n  /** Extra headers merged into every request. */\n  headers?: Record<string, string>\n}\n\n/** Per-call read options. */\nexport interface ReadOptions {\n  /** Set `false` to bypass the cache for this call and always hit the network. */\n  cache?: boolean\n}\n\ntype Method = 'GET' | 'POST' | 'PATCH'\n\n/**\n * Typed client for the StudioLayer content API: read and write a project's node\n * datasets from any website or app. Reads are cached (see the `cache` option);\n * writes invalidate the affected cache entries automatically.\n *\n * ```ts\n * const studio = new StudioLayerClient({ apiKey: 'slk_...', baseUrl: 'https://studio.example.com' })\n * const posts = await studio.dataset<Post>('blog', 'posts').list()\n * ```\n */\nexport class StudioLayerClient {\n  private readonly apiKey: string\n  private readonly baseUrl: string\n  private readonly fetchImpl: typeof fetch\n  private readonly headers: Record<string, string>\n  private readonly cache: ContentCache\n\n  constructor(options: StudioLayerClientOptions) {\n    if (!options.apiKey) throw new Error('StudioLayerClient: `apiKey` is required')\n    if (!options.baseUrl) throw new Error('StudioLayerClient: `baseUrl` is required')\n\n    this.apiKey = options.apiKey\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, '')\n    const resolvedFetch = options.fetch ?? globalThis.fetch\n    if (!resolvedFetch) {\n      throw new Error('StudioLayerClient: no `fetch` available; pass one via options.fetch (Node < 18)')\n    }\n    this.fetchImpl = resolvedFetch.bind(globalThis)\n    this.headers = options.headers ?? {}\n\n    const cacheOpt = options.cache\n    this.cache = new ContentCache(\n      cacheOpt === false ? { enabled: false }\n        : cacheOpt === true || cacheOpt === undefined ? {}\n          : cacheOpt,\n    )\n  }\n\n  // ── Introspection ─────────────────────────────────────────────────────────\n\n  /** The full content shape this key can reach: nodes, datasets, field schemas. */\n  async schema(opts?: ReadOptions): Promise<ContentSchema> {\n    return this.cachedGet<ContentSchema>('schema', '/schema', opts)\n  }\n\n  /** Shorthand for `schema()` then `.nodes`. */\n  async nodes(opts?: ReadOptions): Promise<SchemaNode[]> {\n    return (await this.schema(opts)).nodes\n  }\n\n  // ── Records ───────────────────────────────────────────────────────────────\n\n  /** List every record in a dataset (references inflated). Requires read scope. */\n  async listRecords<T = Record<string, unknown>>(\n    nodeSlug: string,\n    datasetSlug: string,\n    opts?: ReadOptions,\n  ): Promise<ContentRecord<T>[]> {\n    const res = await this.cachedGet<{ records: ContentRecord<T>[] }>(\n      recordsKey(nodeSlug, datasetSlug),\n      datasetPath(nodeSlug, datasetSlug),\n      opts,\n    )\n    return res.records\n  }\n\n  /** Read one record by uid. Requires read scope. Throws 404 if it does not exist. */\n  async getRecord<T = Record<string, unknown>>(\n    nodeSlug: string,\n    datasetSlug: string,\n    recordUid: string,\n    opts?: ReadOptions,\n  ): Promise<ContentRecord<T>> {\n    const res = await this.cachedGet<{ record: ContentRecord<T> }>(\n      recordKey(nodeSlug, datasetSlug, recordUid),\n      `${datasetPath(nodeSlug, datasetSlug)}/${encodeURIComponent(recordUid)}`,\n      opts,\n    )\n    return res.record\n  }\n\n  /** Create a record. Requires write scope. Invalidates cached reads of the dataset. */\n  async createRecord<T = Record<string, unknown>>(\n    nodeSlug: string,\n    datasetSlug: string,\n    data: Record<string, unknown>,\n  ): Promise<ContentRecord<T>> {\n    const res = await this.request<{ record: ContentRecord<T> }>(\n      'POST',\n      datasetPath(nodeSlug, datasetSlug),\n      { data },\n    )\n    this.invalidateDataset(nodeSlug, datasetSlug)\n    return res.record\n  }\n\n  /**\n   * Partially update a record. The patch is merged onto the stored data (omitted\n   * top-level fields are preserved). Requires write scope. Invalidates cached\n   * reads of the dataset and of this record.\n   */\n  async updateRecord<T = Record<string, unknown>>(\n    nodeSlug: string,\n    datasetSlug: string,\n    recordUid: string,\n    data: Record<string, unknown>,\n  ): Promise<ContentRecord<T>> {\n    const res = await this.request<{ record: ContentRecord<T> }>(\n      'PATCH',\n      `${datasetPath(nodeSlug, datasetSlug)}/${encodeURIComponent(recordUid)}`,\n      { data },\n    )\n    this.invalidateDataset(nodeSlug, datasetSlug)\n    this.cache.delete(recordKey(nodeSlug, datasetSlug, recordUid))\n    return res.record\n  }\n\n  // -- Queries --\n\n  /** Run a saved query (`queries.<slug>`) and return its result. Requires read scope. */\n  async query<V = unknown>(querySlug: string, opts?: ReadOptions): Promise<QueryResult<V>> {\n    return this.cachedGet<QueryResult<V>>(\n      `query:${querySlug}`,\n      `/queries/${encodeURIComponent(querySlug)}`,\n      opts,\n    )\n  }\n\n  // ── Fluent dataset handle ───────────────────────────────────────────────────\n\n  /**\n   * A fluent, type-parameterised handle to one dataset:\n   * `client.dataset<Post>('blog', 'posts').list()`.\n   */\n  dataset<T = Record<string, unknown>>(nodeSlug: string, datasetSlug: string): DatasetHandle<T> {\n    return new DatasetHandle<T>(this, nodeSlug, datasetSlug)\n  }\n\n  // ── Cache control ───────────────────────────────────────────────────────────\n\n  /**\n   * Clear cached reads. With no argument, clears everything. Pass a scope to\n   * clear just part of it: a node slug, or `{ node, dataset }` for one dataset.\n   */\n  clearCache(scope?: string | { node: string, dataset?: string }): void {\n    if (scope === undefined) {\n      this.cache.clear()\n      return\n    }\n    if (typeof scope === 'string') {\n      this.cache.deletePrefix(`records:${scope}/`)\n      this.cache.deletePrefix(`record:${scope}/`)\n      return\n    }\n    if (scope.dataset) {\n      this.invalidateDataset(scope.node, scope.dataset)\n    } else {\n      this.cache.deletePrefix(`records:${scope.node}/`)\n      this.cache.deletePrefix(`record:${scope.node}/`)\n    }\n  }\n\n  /** Drop cached record reads for a dataset, plus all query results (which may aggregate it). */\n  private invalidateDataset(nodeSlug: string, datasetSlug: string): void {\n    this.cache.delete(recordsKey(nodeSlug, datasetSlug))\n    this.cache.deletePrefix(`${recordKey(nodeSlug, datasetSlug, '')}`)\n    this.cache.deletePrefix('query:')\n  }\n\n  // ── Transport ───────────────────────────────────────────────────────────────\n\n  private async cachedGet<T>(cacheKey: string, path: string, opts?: ReadOptions): Promise<T> {\n    const useCache = opts?.cache !== false\n    const now = Date.now()\n    if (useCache) {\n      const hit = this.cache.get<T>(cacheKey, now)\n      if (hit !== undefined) return hit\n    }\n    const value = await this.request<T>('GET', path)\n    if (useCache) this.cache.set(cacheKey, value, now)\n    return value\n  }\n\n  private async request<T>(method: Method, path: string, body?: unknown): Promise<T> {\n    const res = await this.fetchImpl(`${this.baseUrl}/api/content${path}`, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n        ...this.headers,\n      },\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    })\n\n    if (!res.ok) {\n      let message = res.statusText || `Request failed with status ${res.status}`\n      let parsed: unknown\n      try {\n        parsed = await res.json()\n        const m = parsed as { message?: unknown, statusMessage?: unknown }\n        if (typeof m?.message === 'string') message = m.message\n        else if (typeof m?.statusMessage === 'string') message = m.statusMessage\n      } catch {\n        /* non-JSON error body; keep the status text */\n      }\n      throw new StudioLayerError(message, res.status, parsed)\n    }\n\n    if (res.status === 204) return undefined as T\n    return res.json() as Promise<T>\n  }\n}\n\n/** Fluent, dataset-scoped view returned by `client.dataset()`. */\nexport class DatasetHandle<T = Record<string, unknown>> {\n  constructor(\n    private readonly client: StudioLayerClient,\n    private readonly nodeSlug: string,\n    private readonly datasetSlug: string,\n  ) {}\n\n  list(opts?: ReadOptions): Promise<ContentRecord<T>[]> {\n    return this.client.listRecords<T>(this.nodeSlug, this.datasetSlug, opts)\n  }\n\n  get(recordUid: string, opts?: ReadOptions): Promise<ContentRecord<T>> {\n    return this.client.getRecord<T>(this.nodeSlug, this.datasetSlug, recordUid, opts)\n  }\n\n  create(data: Record<string, unknown>): Promise<ContentRecord<T>> {\n    return this.client.createRecord<T>(this.nodeSlug, this.datasetSlug, data)\n  }\n\n  update(recordUid: string, data: Record<string, unknown>): Promise<ContentRecord<T>> {\n    return this.client.updateRecord<T>(this.nodeSlug, this.datasetSlug, recordUid, data)\n  }\n\n  /** Clear cached reads for this dataset. */\n  clearCache(): void {\n    this.client.clearCache({ node: this.nodeSlug, dataset: this.datasetSlug })\n  }\n}\n\n// ── Cache-key + path helpers ──────────────────────────────────────────────────\n\nfunction datasetPath(nodeSlug: string, datasetSlug: string): string {\n  return `/nodes/${encodeURIComponent(nodeSlug)}/datasets/${encodeURIComponent(datasetSlug)}/records`\n}\n\nfunction recordsKey(nodeSlug: string, datasetSlug: string): string {\n  return `records:${nodeSlug}/${datasetSlug}`\n}\n\nfunction recordKey(nodeSlug: string, datasetSlug: string, recordUid: string): string {\n  return `record:${nodeSlug}/${datasetSlug}/${recordUid}`\n}\n","export { StudioLayerClient, DatasetHandle } from './client'\nexport type { StudioLayerClientOptions, ReadOptions } from './client'\nexport { StudioLayerError } from './errors'\nexport { ContentCache, MemoryCacheStore } from './cache'\nexport type { CacheOptions, CacheStore, CacheEntry } from './cache'\nexport type {\n  ContentSchema,\n  SchemaNode,\n  SchemaDataset,\n  SchemaField,\n  FieldKind,\n  FieldType,\n  ContentRecord,\n  QueryResult,\n  QueryShape,\n} from './types'\n\nimport { StudioLayerClient, type StudioLayerClientOptions } from './client'\n\n/** Convenience factory: `createClient({ apiKey, baseUrl })`. */\nexport function createClient(options: StudioLayerClientOptions): StudioLayerClient {\n  return new StudioLayerClient(options)\n}\n"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@studiolayer/client",
+  "version": "0.1.0",
+  "description": "Typed client for the StudioLayer content API. Read and write project node datasets from any website or app, headless-CMS style and beyond.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "studiolayer",
+    "headless-cms",
+    "content-api",
+    "cms",
+    "datasets",
+    "client",
+    "sdk"
+  ],
+  "author": "StudioLayer",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  }
+}