@botlr/sdk 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,382 @@
+// src/errors.ts
+var BotlrError = class extends Error {
+  status;
+  details;
+  constructor(message, status, details) {
+    super(message);
+    this.name = "BotlrError";
+    this.status = status;
+    this.details = details;
+  }
+};
+var BotlrConflictError = class extends BotlrError {
+  latest;
+  constructor(message, latest, details) {
+    super(message, 409, details);
+    this.name = "BotlrConflictError";
+    this.latest = latest;
+  }
+};
+
+// src/client.ts
+function toQueryString(query) {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value === void 0 || value === null) continue;
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        if (item !== void 0 && item !== null) {
+          params.append(key, String(item));
+        }
+      }
+    } else {
+      params.set(key, String(value));
+    }
+  }
+  const qs = params.toString();
+  return qs ? `?${qs}` : "";
+}
+function mergeContext(base, override) {
+  if (!base && !override) return void 0;
+  return { ...base, ...override };
+}
+function contextToHeaders(context) {
+  if (!context) return {};
+  return {
+    ...context.appId ? { "x-botlr-app-id": context.appId } : {},
+    ...context.locale ? { "x-botlr-locale": context.locale } : {},
+    ...context.preview !== void 0 ? { "x-botlr-preview": String(context.preview) } : {}
+  };
+}
+async function errorDetails(response) {
+  const text = await response.text().catch(() => void 0);
+  if (text === void 0 || text === "") return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function conflictLatest(details) {
+  if (!details || typeof details !== "object") return null;
+  const detail = details.detail;
+  if (!detail || typeof detail !== "object") return null;
+  const latest = detail.latest;
+  if (!latest || typeof latest !== "object") return null;
+  const { version, contentHash: contentHash2 } = latest;
+  if (typeof version !== "number" || typeof contentHash2 !== "string") return null;
+  return { version, contentHash: contentHash2 };
+}
+function conflictMessage(details) {
+  if (!details || typeof details !== "object") return void 0;
+  const detail = details.detail;
+  if (!detail || typeof detail !== "object") return void 0;
+  const message = detail.message;
+  return typeof message === "string" ? message : void 0;
+}
+function createBotlrClient(config) {
+  const fetcher = config.fetch ?? globalThis.fetch;
+  if (typeof fetcher !== "function") {
+    throw new BotlrError("No fetch implementation: pass `fetch` in the client config");
+  }
+  const baseUrl = config.baseUrl.replace(/\/+$/, "");
+  const baseContext = {
+    appId: config.appId,
+    locale: config.locale,
+    preview: config.preview
+  };
+  async function request(path, options = {}) {
+    const { query, context: contextOverride, headers: extraHeaders, ...init } = options;
+    const context = mergeContext(baseContext, contextOverride);
+    const url = `${baseUrl}${path}${toQueryString(query ?? {})}`;
+    const response = await fetcher(url, {
+      ...init,
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json",
+        ...config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {},
+        ...contextToHeaders(context),
+        ...extraHeaders ?? {}
+      }
+    });
+    if (!response.ok) {
+      const details = await errorDetails(response);
+      if (response.status === 409) {
+        throw new BotlrConflictError(
+          conflictMessage(details) ?? `Botlr request failed with status 409`,
+          conflictLatest(details),
+          details
+        );
+      }
+      throw new BotlrError(`Botlr request failed with status ${response.status}`, response.status, details);
+    }
+    if (response.status === 204) {
+      return void 0;
+    }
+    return await response.json();
+  }
+  const sections = {
+    /** Every section the app can pull for `framework`, with the latest version per scope. */
+    list(params) {
+      return request("/api/sections/source", {
+        method: "GET",
+        query: { framework: params.framework, appInstanceId: baseContext.appId }
+      });
+    },
+    /** The section's source: this app's row first, the shared row second. */
+    pull(name, params) {
+      return request(`/api/sections/${encodeURIComponent(name)}/source`, {
+        method: "GET",
+        query: {
+          framework: params.framework,
+          appInstanceId: baseContext.appId,
+          version: params.version,
+          scope: params.scope
+        }
+      });
+    },
+    /**
+     * Push a new version with the personal access token (`write:sections`).
+     * Resolves with `created: true` on 201 and `created: false` when nothing
+     * changed; throws `BotlrConflictError` when `baseVersion` is not the latest.
+     */
+    push(name, body) {
+      if (!config.personalToken) {
+        return Promise.reject(
+          new BotlrError("sections.push needs `personalToken` (a personal access token with write:sections)")
+        );
+      }
+      const { appInstanceId, ...rest } = body;
+      return request(`/api/sections/${encodeURIComponent(name)}/source`, {
+        method: "PUT",
+        headers: { Authorization: `Bearer ${config.personalToken}` },
+        body: JSON.stringify({ appInstanceId: appInstanceId ?? baseContext.appId, ...rest })
+      });
+    }
+  };
+  return {
+    request,
+    /** The resolved config, for wrappers that need `baseUrl` or `appId`. */
+    config: { ...config, baseUrl },
+    withContext(contextOverride) {
+      return createBotlrClient({ ...config, ...contextOverride });
+    },
+    async getEntryBySlug(params) {
+      const result = await request("/entries/by-slug", {
+        method: "GET",
+        query: { contentType: params.contentType, slug: params.slug, locale: params.locale },
+        context: { locale: params.locale }
+      });
+      return result.item;
+    },
+    async getEntries(params) {
+      const query = {
+        contentType: params.contentType,
+        locale: params.locale,
+        limit: params.limit,
+        offset: params.offset,
+        sort: params.sort
+      };
+      for (const [key, value] of Object.entries(params.filters ?? {})) {
+        query[`filter.${key}`] = value;
+      }
+      return request("/entries", {
+        method: "GET",
+        query,
+        context: { locale: params.locale }
+      });
+    },
+    async getSingleton(params) {
+      const result = await request("/singletons", {
+        method: "GET",
+        query: { key: params.key, locale: params.locale },
+        context: { locale: params.locale }
+      });
+      return result.item;
+    },
+    getPageBySlug(slug, locale) {
+      return request(`/api/pages/${slug}`, {
+        query: {
+          appInstanceId: baseContext.appId,
+          locale: locale || baseContext.locale,
+          mode: baseContext.preview ? "draft" : "published"
+        }
+      });
+    },
+    resolveUrl(slug, locale) {
+      return request("/api/resolve", {
+        query: {
+          slug,
+          appInstanceId: baseContext.appId,
+          locale: locale || baseContext.locale,
+          mode: baseContext.preview ? "draft" : "published",
+          ...baseContext.preview && config.previewToken ? { token: config.previewToken } : {}
+        }
+      });
+    },
+    getPageList(params = {}) {
+      return request("/api/page-lists", {
+        query: {
+          appInstanceId: params.appInstanceId || baseContext.appId,
+          locale: params.locale || baseContext.locale,
+          parentId: params.parentId,
+          tags: params.tags,
+          limit: params.limit,
+          offset: params.offset,
+          type: params.type || "page",
+          orderBy: params.orderBy
+        }
+      });
+    },
+    getPageSlugList(params = {}) {
+      return request("/api/page-lists/slugs", {
+        query: {
+          appInstanceId: params.appInstanceId || baseContext.appId,
+          locale: params.locale || baseContext.locale,
+          limit: params.limit,
+          offset: params.offset
+        }
+      });
+    },
+    getMenu(key, locale) {
+      return request("/api/menus", {
+        query: { key, appInstanceId: baseContext.appId, locale: locale || baseContext.locale }
+      });
+    },
+    getForm(key, locale) {
+      return request("/api/forms", {
+        query: { key, appInstanceId: baseContext.appId, locale: locale || baseContext.locale }
+      });
+    },
+    getList(appId, listId, locale) {
+      return request(`/api/lists/${listId}/complete`, {
+        query: { appInstanceId: appId, locale: locale || baseContext.locale }
+      });
+    },
+    getConfigurator(configuratorId, versionId) {
+      return request(`/api/configurators/${configuratorId}`, {
+        query: { versionId, appInstanceId: baseContext.appId, locale: baseContext.locale }
+      });
+    },
+    /** GET `/api/{endpoint}` with the app and locale added to the query. */
+    getData(endpoint, queryParams, locale) {
+      return request(`/api/${endpoint}`, {
+        method: "GET",
+        query: { appInstanceId: baseContext.appId, locale: locale || baseContext.locale, ...queryParams }
+      });
+    },
+    /** POST `data` as JSON to `/api/{endpoint}`, for forms and other submissions. */
+    submitData(endpoint, data, locale, queryParams) {
+      return request(`/api/${endpoint}`, {
+        method: "POST",
+        body: JSON.stringify(data),
+        query: { appInstanceId: baseContext.appId, locale: locale || baseContext.locale, ...queryParams }
+      });
+    },
+    getAppInfo() {
+      return request(`/api/apps/${baseContext.appId}`);
+    },
+    getSitemap() {
+      return request(`/api/sitemap/${baseContext.appId}`);
+    },
+    /** Every redirect for the app, across all locales. */
+    getRedirects() {
+      return request(`/api/redirects/${baseContext.appId}`);
+    },
+    getAssetById(assetId) {
+      return request(`/api/assets/${assetId}`, {
+        query: { appInstanceId: baseContext.appId }
+      });
+    },
+    sections
+  };
+}
+function createBotlrFactory(defaults) {
+  return {
+    create(config) {
+      return createBotlrClient({ ...defaults, ...config });
+    }
+  };
+}
+
+// src/sections.ts
+var MANIFEST_STATE_KEYS = ["version", "hash", "contentHash", "pulledAt", "scope"];
+var SECTION_SOURCE_LIMITS = {
+  maxFiles: 50,
+  maxFileBytes: 512 * 1024,
+  maxTotalBytes: 2 * 1024 * 1024,
+  maxPathLength: 200,
+  maxMessageLength: 500
+};
+var SECTION_PATH_RE = /^[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*$/;
+var SECTION_FRAMEWORK_RE = /^[a-z0-9][a-z0-9-]{0,31}$/;
+function isValidSectionPath(path) {
+  if (!path || path.length > SECTION_SOURCE_LIMITS.maxPathLength) return false;
+  if (!SECTION_PATH_RE.test(path)) return false;
+  return !path.split("/").some((segment) => segment === "." || segment === "..");
+}
+function isValidFramework(framework) {
+  return SECTION_FRAMEWORK_RE.test(framework);
+}
+var encoder = new TextEncoder();
+function subtle() {
+  const c = globalThis.crypto;
+  if (!c || !c.subtle) {
+    throw new Error("Web Crypto is not available in this runtime (globalThis.crypto.subtle)");
+  }
+  return c.subtle;
+}
+function toHex(buffer) {
+  const bytes = new Uint8Array(buffer);
+  let out = "";
+  for (let i = 0; i < bytes.length; i++) {
+    out += bytes[i].toString(16).padStart(2, "0");
+  }
+  return out;
+}
+async function sha256Hex(input) {
+  return toHex(await subtle().digest("SHA-256", encoder.encode(input)));
+}
+function fileSha256(content) {
+  return sha256Hex(content);
+}
+async function contentHash(files) {
+  const hashed = await hashFiles(files);
+  const lines = hashed.map((f) => [f.path, f.sha256]).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([path, sha]) => `${path}
+${sha}
+`).join("");
+  return sha256Hex(lines);
+}
+async function hashFiles(files) {
+  return Promise.all(
+    files.map(async (f) => ({
+      path: f.path,
+      content: f.content,
+      sha256: "sha256" in f && typeof f.sha256 === "string" ? f.sha256 : await fileSha256(f.content)
+    }))
+  );
+}
+function stripManifestState(manifest) {
+  const copy = { ...manifest };
+  for (const key of MANIFEST_STATE_KEYS) delete copy[key];
+  return copy;
+}
+export {
+  BotlrConflictError,
+  BotlrError,
+  MANIFEST_STATE_KEYS,
+  SECTION_FRAMEWORK_RE,
+  SECTION_PATH_RE,
+  SECTION_SOURCE_LIMITS,
+  contentHash,
+  contextToHeaders,
+  createBotlrClient,
+  createBotlrFactory,
+  fileSha256,
+  hashFiles,
+  isValidFramework,
+  isValidSectionPath,
+  stripManifestState,
+  toQueryString
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/sections.ts"],"sourcesContent":["/**\n * Thrown for every non-2xx response. `status` is the HTTP status and\n * `details` the parsed JSON body (or the raw text when the body is not JSON).\n */\nexport class BotlrError extends Error {\n  readonly status: number | undefined;\n  readonly details: unknown;\n\n  constructor(message: string, status?: number, details?: unknown) {\n    super(message);\n    this.name = \"BotlrError\";\n    this.status = status;\n    this.details = details;\n  }\n}\n\n/** The latest version of a section source, as reported on a push conflict. */\nexport type ConflictLatest = {\n  version: number;\n  contentHash: string;\n};\n\n/**\n * Thrown by `sections.push` on 409: `baseVersion` was not the latest version,\n * or a concurrent push won. `latest` is null when the server has no version\n * at all (the client sent a `baseVersion` above 0 for a section with no source).\n */\nexport class BotlrConflictError extends BotlrError {\n  readonly latest: ConflictLatest | null;\n\n  constructor(message: string, latest: ConflictLatest | null, details?: unknown) {\n    super(message, 409, details);\n    this.name = \"BotlrConflictError\";\n    this.latest = latest;\n  }\n}\n","import type {\n  BotlrClientConfig,\n  BotlrContext,\n  BotlrEntry,\n  BotlrQuery,\n  BotlrQueryValue,\n  FormResponse,\n  GetEntriesParams,\n  GetEntryBySlugParams,\n  GetPageListParams,\n  GetPageSlugListParams,\n  GetSingletonParams,\n  ListResponse,\n  MenuResponse,\n  PageListResponse,\n  PageResponse,\n  PageSlugListResponse,\n  RedirectsResponse,\n  ResolveResponse,\n} from \"./types\";\nimport type {\n  SectionSourceListParams,\n  SectionSourceListResponse,\n  SectionSourcePullParams,\n  SectionSourcePullResponse,\n  SectionSourcePushBody,\n  SectionSourcePushResponse,\n} from \"./sections\";\nimport { BotlrConflictError, BotlrError } from \"./errors\";\n\nexport type RequestOptions = Omit<RequestInit, \"headers\"> & {\n  query?: BotlrQuery;\n  context?: Partial<BotlrContext>;\n  headers?: Record<string, string>;\n};\n\nexport function toQueryString(query: BotlrQuery): string {\n  const params = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) continue;\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        if (item !== undefined && item !== null) {\n          params.append(key, String(item));\n        }\n      }\n    } else {\n      params.set(key, String(value));\n    }\n  }\n\n  const qs = params.toString();\n  return qs ? `?${qs}` : \"\";\n}\n\nfunction mergeContext(\n  base?: Partial<BotlrContext>,\n  override?: Partial<BotlrContext>,\n): Partial<BotlrContext> | undefined {\n  if (!base && !override) return undefined;\n  return { ...base, ...override };\n}\n\nexport function contextToHeaders(context?: Partial<BotlrContext>): Record<string, string> {\n  if (!context) return {};\n\n  return {\n    ...(context.appId ? { \"x-botlr-app-id\": context.appId } : {}),\n    ...(context.locale ? { \"x-botlr-locale\": context.locale } : {}),\n    ...(context.preview !== undefined ? { \"x-botlr-preview\": String(context.preview) } : {}),\n  };\n}\n\nasync function errorDetails(response: Response): Promise<unknown> {\n  const text = await response.text().catch(() => undefined);\n  if (text === undefined || text === \"\") return undefined;\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    return text;\n  }\n}\n\nfunction conflictLatest(details: unknown): { version: number; contentHash: string } | null {\n  if (!details || typeof details !== \"object\") return null;\n  const detail = (details as { detail?: unknown }).detail;\n  if (!detail || typeof detail !== \"object\") return null;\n  const latest = (detail as { latest?: unknown }).latest;\n  if (!latest || typeof latest !== \"object\") return null;\n  const { version, contentHash } = latest as { version?: unknown; contentHash?: unknown };\n  if (typeof version !== \"number\" || typeof contentHash !== \"string\") return null;\n  return { version, contentHash };\n}\n\nfunction conflictMessage(details: unknown): string | undefined {\n  if (!details || typeof details !== \"object\") return undefined;\n  const detail = (details as { detail?: unknown }).detail;\n  if (!detail || typeof detail !== \"object\") return undefined;\n  const message = (detail as { message?: unknown }).message;\n  return typeof message === \"string\" ? message : undefined;\n}\n\nexport type BotlrClient = ReturnType<typeof createBotlrClient>;\n\n/**\n * A Botlr client. Every call sends the site token as `Authorization: Bearer`\n * plus `x-botlr-app-id`, `x-botlr-locale` and `x-botlr-preview` from the\n * config; `sections.push` sends the personal token instead.\n */\nexport function createBotlrClient(config: BotlrClientConfig) {\n  const fetcher = config.fetch ?? globalThis.fetch;\n  if (typeof fetcher !== \"function\") {\n    throw new BotlrError(\"No fetch implementation: pass `fetch` in the client config\");\n  }\n  const baseUrl = config.baseUrl.replace(/\\/+$/, \"\");\n\n  const baseContext: BotlrContext = {\n    appId: config.appId,\n    locale: config.locale,\n    preview: config.preview,\n  };\n\n  async function request<T>(path: string, options: RequestOptions = {}): Promise<T> {\n    const { query, context: contextOverride, headers: extraHeaders, ...init } = options;\n    const context = mergeContext(baseContext, contextOverride);\n    const url = `${baseUrl}${path}${toQueryString(query ?? {})}`;\n\n    const response = await fetcher(url, {\n      ...init,\n      headers: {\n        Accept: \"application/json\",\n        \"Content-Type\": \"application/json\",\n        ...(config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {}),\n        ...contextToHeaders(context),\n        ...(extraHeaders ?? {}),\n      },\n    });\n\n    if (!response.ok) {\n      const details = await errorDetails(response);\n      if (response.status === 409) {\n        throw new BotlrConflictError(\n          conflictMessage(details) ?? `Botlr request failed with status 409`,\n          conflictLatest(details),\n          details,\n        );\n      }\n      throw new BotlrError(`Botlr request failed with status ${response.status}`, response.status, details);\n    }\n\n    if (response.status === 204) {\n      return undefined as T;\n    }\n\n    return (await response.json()) as T;\n  }\n\n  const sections = {\n    /** Every section the app can pull for `framework`, with the latest version per scope. */\n    list(params: SectionSourceListParams): Promise<SectionSourceListResponse> {\n      return request<SectionSourceListResponse>(\"/api/sections/source\", {\n        method: \"GET\",\n        query: { framework: params.framework, appInstanceId: baseContext.appId },\n      });\n    },\n\n    /** The section's source: this app's row first, the shared row second. */\n    pull(name: string, params: SectionSourcePullParams): Promise<SectionSourcePullResponse> {\n      return request<SectionSourcePullResponse>(`/api/sections/${encodeURIComponent(name)}/source`, {\n        method: \"GET\",\n        query: {\n          framework: params.framework,\n          appInstanceId: baseContext.appId,\n          version: params.version,\n          scope: params.scope,\n        },\n      });\n    },\n\n    /**\n     * Push a new version with the personal access token (`write:sections`).\n     * Resolves with `created: true` on 201 and `created: false` when nothing\n     * changed; throws `BotlrConflictError` when `baseVersion` is not the latest.\n     */\n    push(name: string, body: SectionSourcePushBody): Promise<SectionSourcePushResponse> {\n      if (!config.personalToken) {\n        return Promise.reject(\n          new BotlrError(\"sections.push needs `personalToken` (a personal access token with write:sections)\"),\n        );\n      }\n      const { appInstanceId, ...rest } = body;\n      return request<SectionSourcePushResponse>(`/api/sections/${encodeURIComponent(name)}/source`, {\n        method: \"PUT\",\n        headers: { Authorization: `Bearer ${config.personalToken}` },\n        body: JSON.stringify({ appInstanceId: appInstanceId ?? baseContext.appId, ...rest }),\n      });\n    },\n  };\n\n  return {\n    request,\n\n    /** The resolved config, for wrappers that need `baseUrl` or `appId`. */\n    config: { ...config, baseUrl } as Readonly<BotlrClientConfig>,\n\n    withContext(contextOverride: Partial<BotlrContext>) {\n      return createBotlrClient({ ...config, ...contextOverride });\n    },\n\n    async getEntryBySlug<TFields>(params: GetEntryBySlugParams): Promise<BotlrEntry<TFields> | null> {\n      const result = await request<{ item: BotlrEntry<TFields> | null }>(\"/entries/by-slug\", {\n        method: \"GET\",\n        query: { contentType: params.contentType, slug: params.slug, locale: params.locale },\n        context: { locale: params.locale },\n      });\n      return result.item;\n    },\n\n    async getEntries<TFields>(\n      params: GetEntriesParams,\n    ): Promise<{ items: BotlrEntry<TFields>[]; total: number }> {\n      const query: Record<string, BotlrQueryValue> = {\n        contentType: params.contentType,\n        locale: params.locale,\n        limit: params.limit,\n        offset: params.offset,\n        sort: params.sort,\n      };\n      for (const [key, value] of Object.entries(params.filters ?? {})) {\n        query[`filter.${key}`] = value;\n      }\n      return request<{ items: BotlrEntry<TFields>[]; total: number }>(\"/entries\", {\n        method: \"GET\",\n        query,\n        context: { locale: params.locale },\n      });\n    },\n\n    async getSingleton<TFields>(params: GetSingletonParams): Promise<BotlrEntry<TFields> | null> {\n      const result = await request<{ item: BotlrEntry<TFields> | null }>(\"/singletons\", {\n        method: \"GET\",\n        query: { key: params.key, locale: params.locale },\n        context: { locale: params.locale },\n      });\n      return result.item;\n    },\n\n    getPageBySlug(slug: string, locale?: string) {\n      return request<PageResponse>(`/api/pages/${slug}`, {\n        query: {\n          appInstanceId: baseContext.appId,\n          locale: locale || baseContext.locale,\n          mode: baseContext.preview ? \"draft\" : \"published\",\n        },\n      });\n    },\n\n    resolveUrl(slug: string, locale?: string) {\n      return request<ResolveResponse>(\"/api/resolve\", {\n        query: {\n          slug,\n          appInstanceId: baseContext.appId,\n          locale: locale || baseContext.locale,\n          mode: baseContext.preview ? \"draft\" : \"published\",\n          ...(baseContext.preview && config.previewToken ? { token: config.previewToken } : {}),\n        },\n      });\n    },\n\n    getPageList(params: GetPageListParams = {}) {\n      return request<PageListResponse>(\"/api/page-lists\", {\n        query: {\n          appInstanceId: params.appInstanceId || baseContext.appId,\n          locale: params.locale || baseContext.locale,\n          parentId: params.parentId,\n          tags: params.tags,\n          limit: params.limit,\n          offset: params.offset,\n          type: params.type || \"page\",\n          orderBy: params.orderBy,\n        },\n      });\n    },\n\n    getPageSlugList(params: GetPageSlugListParams = {}) {\n      return request<PageSlugListResponse>(\"/api/page-lists/slugs\", {\n        query: {\n          appInstanceId: params.appInstanceId || baseContext.appId,\n          locale: params.locale || baseContext.locale,\n          limit: params.limit,\n          offset: params.offset,\n        },\n      });\n    },\n\n    getMenu(key: string, locale?: string) {\n      return request<MenuResponse>(\"/api/menus\", {\n        query: { key, appInstanceId: baseContext.appId, locale: locale || baseContext.locale },\n      });\n    },\n\n    getForm(key: string, locale?: string) {\n      return request<FormResponse>(\"/api/forms\", {\n        query: { key, appInstanceId: baseContext.appId, locale: locale || baseContext.locale },\n      });\n    },\n\n    getList(appId: string, listId: string, locale?: string) {\n      return request<ListResponse>(`/api/lists/${listId}/complete`, {\n        query: { appInstanceId: appId, locale: locale || baseContext.locale },\n      });\n    },\n\n    getConfigurator<T = unknown>(configuratorId: string, versionId?: string) {\n      return request<T>(`/api/configurators/${configuratorId}`, {\n        query: { versionId, appInstanceId: baseContext.appId, locale: baseContext.locale },\n      });\n    },\n\n    /** GET `/api/{endpoint}` with the app and locale added to the query. */\n    getData<T = unknown>(endpoint: string, queryParams?: BotlrQuery, locale?: string) {\n      return request<T>(`/api/${endpoint}`, {\n        method: \"GET\",\n        query: { appInstanceId: baseContext.appId, locale: locale || baseContext.locale, ...queryParams },\n      });\n    },\n\n    /** POST `data` as JSON to `/api/{endpoint}`, for forms and other submissions. */\n    submitData<T = unknown>(\n      endpoint: string,\n      data: Record<string, unknown>,\n      locale?: string,\n      queryParams?: BotlrQuery,\n    ) {\n      return request<T>(`/api/${endpoint}`, {\n        method: \"POST\",\n        body: JSON.stringify(data),\n        query: { appInstanceId: baseContext.appId, locale: locale || baseContext.locale, ...queryParams },\n      });\n    },\n\n    getAppInfo<T = unknown>() {\n      return request<T>(`/api/apps/${baseContext.appId}`);\n    },\n\n    getSitemap<T = unknown>() {\n      return request<T>(`/api/sitemap/${baseContext.appId}`);\n    },\n\n    /** Every redirect for the app, across all locales. */\n    getRedirects() {\n      return request<RedirectsResponse>(`/api/redirects/${baseContext.appId}`);\n    },\n\n    getAssetById<T = unknown>(assetId: string) {\n      return request<T>(`/api/assets/${assetId}`, {\n        query: { appInstanceId: baseContext.appId },\n      });\n    },\n\n    sections,\n  };\n}\n\nexport function createBotlrFactory(defaults?: { fetch?: typeof fetch }) {\n  return {\n    create(config: Omit<BotlrClientConfig, \"fetch\">) {\n      return createBotlrClient({ ...defaults, ...config });\n    },\n  };\n}\n","/**\n * Section source bridge: types and hash helpers.\n *\n * Mirrors the contract in xam-mono's docs/SECTION_SOURCE_BRIDGE.md. The hash\n * rules are reproduced here exactly as the server computes them, so a client\n * can tell \"clean\", \"modified\", \"behind\" and \"diverged\" apart without a\n * round trip:\n *\n * - `file.sha256`  = sha256 of the UTF-8 content, hex, content exactly as sent\n * - `contentHash`  = sha256 over `\"{path}\\n{sha256}\\n\"` for every file, sorted by path\n *\n * The manifest is not hashed.\n */\n\n/** The source variant a section is stored for, for example `react-next` or `html`. */\nexport type SectionFramework = string;\n\nexport type SectionSourceScope = \"instance\" | \"shared\";\n\n/** `<slug>.botlr.json`, kept next to the section's entry file. */\nexport interface SectionManifest {\n  /** Section definition slug. Must equal the name used in the URL on push. */\n  section: string;\n  framework: SectionFramework;\n  /** Entry file, relative to the manifest's directory. Must be listed in `files`. */\n  entry: string;\n  /** Named export of the component in `entry`. */\n  exportName?: string;\n  /** Every file of the section, relative to the manifest's directory, forward slashes only. */\n  files: string[];\n  title?: string;\n  description?: string;\n  category?: string;\n  icon?: string;\n  dependencies?: SectionDependencies;\n  /** Unknown keys are kept by the server. */\n  [key: string]: unknown;\n}\n\nexport interface SectionDependencies {\n  /** npm packages the section imports, with the ranges the app uses. */\n  npm?: Record<string, string>;\n  /** Local modules the section imports; the pulling app must already have them. */\n  internal?: string[];\n}\n\n/**\n * Pull state keys the server strips from a manifest. The CLI keeps these in\n * `.botlr/sections.lock.json`, never in the manifest.\n */\nexport const MANIFEST_STATE_KEYS = [\"version\", \"hash\", \"contentHash\", \"pulledAt\", \"scope\"] as const;\n\nexport interface SectionSourceFileInput {\n  path: string;\n  content: string;\n}\n\nexport interface SectionSourceFile extends SectionSourceFileInput {\n  sha256: string;\n}\n\nexport interface SectionDefinitionScope {\n  tenantId: string;\n  organizationId: string | null;\n  projectId: string | null;\n}\n\nexport interface SectionDefinition {\n  id: string;\n  name: string;\n  title: string;\n  schema: Record<string, unknown>;\n  scope: SectionDefinitionScope;\n}\n\nexport interface SectionSource {\n  scope: SectionSourceScope;\n  framework: SectionFramework;\n  version: number;\n  contentHash: string;\n  manifest: SectionManifest;\n  message: string | null;\n  createdAt: string;\n  files: SectionSourceFile[];\n}\n\nexport interface SectionSourceScopeSummary {\n  version: number;\n  contentHash: string;\n  updatedAt: string;\n}\n\nexport interface SectionSourceSummary {\n  name: string;\n  title: string;\n  definitionId: string;\n  instance: SectionSourceScopeSummary | null;\n  shared: SectionSourceScopeSummary | null;\n  /** Which scope a pull without `scope` returns. */\n  effective: SectionSourceScope;\n}\n\nexport interface SectionSourceListResponse {\n  framework: SectionFramework;\n  sections: SectionSourceSummary[];\n}\n\nexport interface SectionSourcePullResponse {\n  /** null only for an instance row whose section no longer resolves to a definition */\n  definition: SectionDefinition | null;\n  source: SectionSource;\n}\n\nexport interface SectionSourceListParams {\n  framework: SectionFramework;\n}\n\nexport interface SectionSourcePullParams {\n  framework: SectionFramework;\n  /** A specific version; latest when omitted. */\n  version?: number;\n  /** Force one scope instead of \"instance first, shared second\". */\n  scope?: SectionSourceScope;\n}\n\nexport interface SectionSourcePushBody {\n  framework: SectionFramework;\n  manifest: SectionManifest;\n  files: SectionSourceFileInput[];\n  /** Defaults to the client's `appId`. */\n  appInstanceId?: string;\n  /** Write the shared row (per section definition) instead of this app's row. */\n  shared?: boolean;\n  /**\n   * The version the push is based on; 0 means \"none yet\". Omit to force the\n   * push without a conflict check.\n   */\n  baseVersion?: number;\n  /** At most 500 characters. */\n  message?: string;\n  /** Add a project-scoped section definition when none exists. */\n  create?: boolean;\n}\n\nexport interface SectionSourcePushResponse {\n  /** true on 201 (new version), false on 200 (nothing changed) */\n  created: boolean;\n  scope: SectionSourceScope;\n  definition: SectionDefinition;\n  version: number;\n  contentHash: string;\n}\n\n// ---------------------------------------------------------------------------\n// Limits, as enforced by the server\n// ---------------------------------------------------------------------------\n\nexport const SECTION_SOURCE_LIMITS = {\n  maxFiles: 50,\n  maxFileBytes: 512 * 1024,\n  maxTotalBytes: 2 * 1024 * 1024,\n  maxPathLength: 200,\n  maxMessageLength: 500,\n} as const;\n\nexport const SECTION_PATH_RE = /^[A-Za-z0-9._-]+(?:\\/[A-Za-z0-9._-]+)*$/;\nexport const SECTION_FRAMEWORK_RE = /^[a-z0-9][a-z0-9-]{0,31}$/;\n\n/** True when `path` is a relative path the bridge accepts. */\nexport function isValidSectionPath(path: string): boolean {\n  if (!path || path.length > SECTION_SOURCE_LIMITS.maxPathLength) return false;\n  if (!SECTION_PATH_RE.test(path)) return false;\n  return !path.split(\"/\").some((segment) => segment === \".\" || segment === \"..\");\n}\n\nexport function isValidFramework(framework: string): boolean {\n  return SECTION_FRAMEWORK_RE.test(framework);\n}\n\n// ---------------------------------------------------------------------------\n// Hashing (Web Crypto, so it runs in the browser, Node 20+ and edge runtimes)\n// ---------------------------------------------------------------------------\n\nconst encoder = new TextEncoder();\n\nfunction subtle(): SubtleCrypto {\n  const c = globalThis.crypto;\n  if (!c || !c.subtle) {\n    throw new Error(\"Web Crypto is not available in this runtime (globalThis.crypto.subtle)\");\n  }\n  return c.subtle;\n}\n\nfunction toHex(buffer: ArrayBuffer): string {\n  const bytes = new Uint8Array(buffer);\n  let out = \"\";\n  for (let i = 0; i < bytes.length; i++) {\n    out += bytes[i]!.toString(16).padStart(2, \"0\");\n  }\n  return out;\n}\n\nasync function sha256Hex(input: string): Promise<string> {\n  return toHex(await subtle().digest(\"SHA-256\", encoder.encode(input)));\n}\n\n/** sha256 of the UTF-8 encoding of `content`, as lowercase hex. */\nexport function fileSha256(content: string): Promise<string> {\n  return sha256Hex(content);\n}\n\n/**\n * The content hash of a file set: sha256 over `\"{path}\\n{sha256}\\n\"` for every\n * file, sorted by path. Accepts files with a precomputed `sha256` or plain\n * `{ path, content }` pairs.\n */\nexport async function contentHash(\n  files: ReadonlyArray<SectionSourceFileInput | SectionSourceFile>,\n): Promise<string> {\n  const hashed = await hashFiles(files);\n  const lines = hashed\n    .map((f) => [f.path, f.sha256] as const)\n    .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n    .map(([path, sha]) => `${path}\\n${sha}\\n`)\n    .join(\"\");\n  return sha256Hex(lines);\n}\n\n/** Every file with its `sha256`, in the order given. Files that already carry one are kept as is. */\nexport async function hashFiles(\n  files: ReadonlyArray<SectionSourceFileInput | SectionSourceFile>,\n): Promise<SectionSourceFile[]> {\n  return Promise.all(\n    files.map(async (f) => ({\n      path: f.path,\n      content: f.content,\n      sha256: \"sha256\" in f && typeof f.sha256 === \"string\" ? f.sha256 : await fileSha256(f.content),\n    })),\n  );\n}\n\n/** A copy of `manifest` without the pull-state keys the server strips. */\nexport function stripManifestState<T extends Record<string, unknown>>(manifest: T): SectionManifest {\n  const copy: Record<string, unknown> = { ...manifest };\n  for (const key of MANIFEST_STATE_KEYS) delete copy[key];\n  return copy as SectionManifest;\n}\n"],"mappings":"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","names":["contentHash"]}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@botlr/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Fetch-only Botlr client and shared types. Works in the browser, Node and edge runtimes.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/botlr-io/botlr.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/botlr-io/botlr/tree/main/packages/sdk#readme",
+  "keywords": [
+    "botlr",
+    "cms",
+    "sdk",
+    "headless"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "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",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "~5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
 }