@puckeditor/cloud-client 0.7.0-canary.75c0f12c → 0.7.0

package/dist/experimental.mjs

@@ -0,0 +1,358 @@
+import {
+  chat,
+  createAttachments,
+  deleteAttachment,
+  endpoints,
+  findRouteInRegistry,
+  generate,
+  getApiKey,
+  getAttachment,
+  handlePuckRequest,
+  tool
+} from "./chunk-4OIQ53M4.mjs";
+import {
+  init_react_import
+} from "./chunk-O6DC5HI2.mjs";
+
+// src/experimental.ts
+init_react_import();
+
+// src/api/pages/routes.ts
+init_react_import();
+
+// src/api/pages/lib/request-context.ts
+init_react_import();
+
+// src/api/pages/lib/utils.ts
+init_react_import();
+var DEFAULT_HOST = "https://cloud.puckeditor.com/api";
+var normalizeHost = (host) => host.replace(/\/+$/, "");
+var normalizeMaybeString = (value) => {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+};
+var buildQueryString = ({
+  path,
+  versionId
+}) => {
+  const searchParams = new URLSearchParams();
+  if (path) {
+    searchParams.set("path", path);
+  }
+  if (versionId) {
+    searchParams.set("versionId", versionId);
+  }
+  const queryString = searchParams.toString();
+  return queryString ? `?${queryString}` : "";
+};
+var getErrorText = async (res) => {
+  try {
+    const body = await res.json();
+    return body?.error ?? "Unknown reason";
+  } catch {
+    return "Unknown reason";
+  }
+};
+
+// src/api/pages/lib/request-context.ts
+var getSiteId = (context, options) => normalizeMaybeString(context.headers.get("x-site-id")) ?? normalizeMaybeString(options.pages?.siteId) ?? normalizeMaybeString(process.env.PUCK_SITE_ID);
+var getRequiredSiteId = (context, options) => {
+  const siteId = getSiteId(context, options);
+  if (!siteId) {
+    throw new Error(
+      "Missing site-id. Set PUCK_SITE_ID, provide pages.siteId, or send x-site-id."
+    );
+  }
+  return siteId;
+};
+var getToken = (context) => normalizeMaybeString(context.headers.get("x-one-time-token"));
+
+// src/api/pages/lib/request-cloud-page.ts
+init_react_import();
+var internalError = (error) => Response.json(
+  {
+    status: 500,
+    error: error instanceof Error ? error.message : "An unexpected error occurred"
+  },
+  { status: 500 }
+);
+var createNewResponse = async (response) => {
+  const body = response.status === 204 || response.status === 304 ? null : await response.arrayBuffer();
+  const contentType = response.headers.get("content-type");
+  const headers = new Headers();
+  if (contentType) {
+    headers.set("content-type", contentType);
+  }
+  return new Response(body, {
+    headers,
+    status: response.status,
+    statusText: response.statusText
+  });
+};
+var requestCloudPage = async (route, {
+  body,
+  method = "GET",
+  path,
+  siteId,
+  token,
+  versionId
+}, options = {}) => {
+  const apiKey = options.apiKey ?? getApiKey();
+  const host = normalizeHost(options.host ?? DEFAULT_HOST);
+  if (!apiKey && !token) {
+    throw new Error(
+      "No Puck API key specified. Set the PUCK_API_KEY environment variable, or provide one to the function"
+    );
+  }
+  return fetch(`${host}${route}${buildQueryString({ path, versionId })}`, {
+    method,
+    headers: {
+      "x-site-id": siteId,
+      ...token ? { "x-one-time-token": token } : {},
+      ...apiKey && !token ? { "x-api-key": apiKey } : {},
+      ...body ? { "content-type": "application/json" } : {}
+    },
+    ...body ? { body: JSON.stringify(body) } : {}
+  });
+};
+var proxyCloudPage = async (route, request, options) => {
+  try {
+    const response = await requestCloudPage(route, request, options);
+    return createNewResponse(response);
+  } catch (error) {
+    return internalError(error);
+  }
+};
+
+// src/api/pages/routes.ts
+var getPagesForSite = async (context, options = {}) => {
+  const siteId = getRequiredSiteId(context, options);
+  return proxyCloudPage(
+    "/pages",
+    {
+      path: normalizeMaybeString(context.query.path),
+      siteId,
+      token: getToken(context),
+      versionId: normalizeMaybeString(context.query.versionId)
+    },
+    options
+  );
+};
+var getPage = async (context, options = {}) => {
+  const siteId = getRequiredSiteId(context, options);
+  const id = normalizeMaybeString(context.params.id);
+  if (!id) {
+    return Response.json(
+      { status: 400, error: "Missing page id" },
+      { status: 400 }
+    );
+  }
+  return proxyCloudPage(
+    `/pages/${id}`,
+    {
+      siteId,
+      token: getToken(context),
+      versionId: normalizeMaybeString(context.query.versionId)
+    },
+    options
+  );
+};
+var createPage = async (context, options = {}) => {
+  const siteId = getRequiredSiteId(context, options);
+  return proxyCloudPage(
+    "/pages",
+    {
+      body: context.body,
+      method: "POST",
+      siteId,
+      token: getToken(context)
+    },
+    options
+  );
+};
+var updatePage = async (context, options = {}) => {
+  const siteId = getRequiredSiteId(context, options);
+  const id = normalizeMaybeString(context.params.id);
+  if (!id) {
+    return Response.json(
+      { status: 400, error: "Missing page id" },
+      { status: 400 }
+    );
+  }
+  return proxyCloudPage(
+    `/pages/${id}`,
+    {
+      body: context.body,
+      method: "POST",
+      siteId,
+      token: getToken(context)
+    },
+    options
+  );
+};
+var deletePage = async (context, options = {}) => {
+  const siteId = getRequiredSiteId(context, options);
+  const id = normalizeMaybeString(context.params.id);
+  if (!id) {
+    return Response.json(
+      { status: 400, error: "Missing page id" },
+      { status: 400 }
+    );
+  }
+  return proxyCloudPage(
+    `/pages/${id}`,
+    {
+      method: "DELETE",
+      siteId,
+      token: getToken(context)
+    },
+    options
+  );
+};
+
+// src/api/sites/verify-puck-host.ts
+init_react_import();
+var verifyPuckHost = async ({
+  host,
+  siteId,
+  token
+}) => {
+  const resolvedSiteId = normalizeMaybeString(
+    siteId || process.env.PUCK_SITE_ID
+  );
+  const resolvedToken = normalizeMaybeString(token);
+  if (!resolvedSiteId || !resolvedToken) {
+    return false;
+  }
+  const res = await fetch(
+    `${normalizeHost(host ?? DEFAULT_HOST)}/sites/verify-host`,
+    {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        siteId: resolvedSiteId,
+        token: resolvedToken
+      })
+    }
+  );
+  if (res.status === 400 || res.status === 401) {
+    return false;
+  }
+  if (!res.ok) {
+    throw new Error(
+      `Puck ${res.status} (${res.statusText}): ${await getErrorText(res)}`
+    );
+  }
+  let body;
+  try {
+    body = await res.json();
+  } catch {
+    return false;
+  }
+  return body.ok === true;
+};
+
+// src/api/pages.ts
+init_react_import();
+
+// src/api/pages/get-published-page-data.ts
+init_react_import();
+var getPublishedPageData = async ({
+  apiKey,
+  host,
+  path,
+  siteId
+}) => {
+  const resolvedSiteId = normalizeMaybeString(siteId) ?? normalizeMaybeString(process.env.PUCK_SITE_ID);
+  if (!resolvedSiteId) {
+    throw new Error(
+      "Missing site-id. Set PUCK_SITE_ID or provide siteId to getPage."
+    );
+  }
+  const res = await requestCloudPage(
+    "/pages/published",
+    {
+      path: normalizeMaybeString(path),
+      siteId: resolvedSiteId
+    },
+    {
+      ...host ? { host } : {},
+      ...apiKey ? { apiKey } : {}
+    }
+  );
+  if (res.status === 404) {
+    return null;
+  }
+  if (!res.ok) {
+    throw new Error(
+      `Puck ${res.status} (${res.statusText}): ${await getErrorText(res)}`
+    );
+  }
+  let body;
+  try {
+    body = await res.json();
+  } catch {
+    return null;
+  }
+  return body.page?.versions?.at(0)?.data ?? null;
+};
+
+// src/experimental.ts
+var routeRegistry = [
+  {
+    pattern: "/api/puck/chat/attachments/:attachmentId",
+    methods: {
+      DELETE: deleteAttachment,
+      GET: getAttachment
+    }
+  },
+  {
+    pattern: "/api/puck/chat/attachments",
+    methods: {
+      POST: createAttachments
+    }
+  },
+  {
+    pattern: "/api/puck/chat",
+    methods: {
+      POST: ({ body }, options) => chat(body, options)
+    }
+  },
+  {
+    pattern: "/api/puck/pages/published",
+    methods: {}
+  },
+  {
+    pattern: "/api/puck/pages/:id",
+    methods: {
+      DELETE: deletePage,
+      GET: getPage,
+      POST: updatePage
+    }
+  },
+  {
+    pattern: "/api/puck/pages",
+    methods: {
+      GET: getPagesForSite,
+      POST: createPage
+    }
+  }
+];
+var findRoute = (pathname, method) => findRouteInRegistry(routeRegistry, pathname, method);
+async function puckHandler(request, options = {}) {
+  return handlePuckRequest(request, options, findRoute);
+}
+export {
+  chat,
+  endpoints,
+  generate,
+  getPublishedPageData as getPage,
+  puckHandler,
+  tool,
+  verifyPuckHost
+};

package/dist/index.d.mts

@@ -27,6 +27,20 @@ type DataFinish = {
     tokenUsage: TokenUsage;
 };
 
+type OnFinishResult = DataFinish;
+type OnFinishCallback = (result: OnFinishResult) => void;
+type UserToolRegistry = Record<string, UserTool>;
+type PuckAiOptions = {
+    context?: string;
+    tools?: UserToolRegistry;
+    onFinish?: OnFinishCallback;
+};
+type PuckCloudOptions = {
+    ai?: PuckAiOptions;
+    host?: string;
+    apiKey?: string;
+};
+
 declare const tool: <INPUT extends z.ZodTypeAny, OUTPUT extends z.ZodTypeAny>(t: UserTool<INPUT, OUTPUT>) => UserTool<INPUT, OUTPUT>;
 
 type ChatParams = {
@@ -42,30 +56,16 @@ type GenerateParams = {
     config: Config;
     pageData?: Data;
     context?: string;
-    collectionId?: string;
     tools?: UserToolRegistry;
     host?: string;
     apiKey?: string;
     onFinish?: OnFinishCallback;
 };
-declare function generate({ prompt, config, pageData, context, collectionId, tools, apiKey, host, onFinish, }: GenerateParams): Promise<null>;
+declare function generate({ prompt, config, pageData, context, tools, apiKey, host, onFinish, }: GenerateParams): Promise<null>;
 
-declare function puckHandler(request: Request, options: PuckCloudOptions): Promise<Response>;
+declare function puckHandler(request: Request, options?: PuckCloudOptions): Promise<Response>;
 
 declare const endpoints: readonly ["chat"];
 type Endpoint = (typeof endpoints)[number];
-type OnFinishResult = DataFinish;
-type OnFinishCallback = (result: OnFinishResult) => void;
-type PuckCloudOptions = {
-    ai?: {
-        context?: string;
-        collectionId?: string;
-        tools?: UserToolRegistry;
-        onFinish?: OnFinishCallback;
-    };
-    host?: string;
-    apiKey?: string;
-};
-type UserToolRegistry = Record<string, UserTool>;
 
 export { type ChatParams, type Endpoint, type GenerateParams, type OnFinishCallback, type OnFinishResult, type PuckCloudOptions, type UserTool, type UserToolRegistry, chat, endpoints, generate, puckHandler, tool };

package/dist/index.d.ts

@@ -27,6 +27,20 @@ type DataFinish = {
     tokenUsage: TokenUsage;
 };
 
+type OnFinishResult = DataFinish;
+type OnFinishCallback = (result: OnFinishResult) => void;
+type UserToolRegistry = Record<string, UserTool>;
+type PuckAiOptions = {
+    context?: string;
+    tools?: UserToolRegistry;
+    onFinish?: OnFinishCallback;
+};
+type PuckCloudOptions = {
+    ai?: PuckAiOptions;
+    host?: string;
+    apiKey?: string;
+};
+
 declare const tool: <INPUT extends z.ZodTypeAny, OUTPUT extends z.ZodTypeAny>(t: UserTool<INPUT, OUTPUT>) => UserTool<INPUT, OUTPUT>;
 
 type ChatParams = {
@@ -42,30 +56,16 @@ type GenerateParams = {
     config: Config;
     pageData?: Data;
     context?: string;
-    collectionId?: string;
     tools?: UserToolRegistry;
     host?: string;
     apiKey?: string;
     onFinish?: OnFinishCallback;
 };
-declare function generate({ prompt, config, pageData, context, collectionId, tools, apiKey, host, onFinish, }: GenerateParams): Promise<null>;
+declare function generate({ prompt, config, pageData, context, tools, apiKey, host, onFinish, }: GenerateParams): Promise<null>;
 
-declare function puckHandler(request: Request, options: PuckCloudOptions): Promise<Response>;
+declare function puckHandler(request: Request, options?: PuckCloudOptions): Promise<Response>;
 
 declare const endpoints: readonly ["chat"];
 type Endpoint = (typeof endpoints)[number];
-type OnFinishResult = DataFinish;
-type OnFinishCallback = (result: OnFinishResult) => void;
-type PuckCloudOptions = {
-    ai?: {
-        context?: string;
-        collectionId?: string;
-        tools?: UserToolRegistry;
-        onFinish?: OnFinishCallback;
-    };
-    host?: string;
-    apiKey?: string;
-};
-type UserToolRegistry = Record<string, UserTool>;
 
 export { type ChatParams, type Endpoint, type GenerateParams, type OnFinishCallback, type OnFinishResult, type PuckCloudOptions, type UserTool, type UserToolRegistry, chat, endpoints, generate, puckHandler, tool };