@dyrected/sdk 0.0.1 → 1.0.0

package/dist/index.js

@@ -1,448 +1,6 @@
 // src/index.ts
 import qs from "qs";
 
-// ../../node_modules/.pnpm/hono@4.12.18/node_modules/hono/dist/request/constants.js
-var GET_MATCH_RESULT = /* @__PURE__ */ Symbol();
-
-// ../../node_modules/.pnpm/hono@4.12.18/node_modules/hono/dist/utils/body.js
-var parseBody = async (request, options = /* @__PURE__ */ Object.create(null)) => {
-  const { all = false, dot = false } = options;
-  const headers = request instanceof HonoRequest ? request.raw.headers : request.headers;
-  const contentType = headers.get("Content-Type");
-  if (contentType?.startsWith("multipart/form-data") || contentType?.startsWith("application/x-www-form-urlencoded")) {
-    return parseFormData(request, { all, dot });
-  }
-  return {};
-};
-async function parseFormData(request, options) {
-  const formData = await request.formData();
-  if (formData) {
-    return convertFormDataToBodyData(formData, options);
-  }
-  return {};
-}
-function convertFormDataToBodyData(formData, options) {
-  const form = /* @__PURE__ */ Object.create(null);
-  formData.forEach((value, key) => {
-    const shouldParseAllValues = options.all || key.endsWith("[]");
-    if (!shouldParseAllValues) {
-      form[key] = value;
-    } else {
-      handleParsingAllValues(form, key, value);
-    }
-  });
-  if (options.dot) {
-    Object.entries(form).forEach(([key, value]) => {
-      const shouldParseDotValues = key.includes(".");
-      if (shouldParseDotValues) {
-        handleParsingNestedValues(form, key, value);
-        delete form[key];
-      }
-    });
-  }
-  return form;
-}
-var handleParsingAllValues = (form, key, value) => {
-  if (form[key] !== void 0) {
-    if (Array.isArray(form[key])) {
-      ;
-      form[key].push(value);
-    } else {
-      form[key] = [form[key], value];
-    }
-  } else {
-    if (!key.endsWith("[]")) {
-      form[key] = value;
-    } else {
-      form[key] = [value];
-    }
-  }
-};
-var handleParsingNestedValues = (form, key, value) => {
-  if (/(?:^|\.)__proto__\./.test(key)) {
-    return;
-  }
-  let nestedForm = form;
-  const keys = key.split(".");
-  keys.forEach((key2, index) => {
-    if (index === keys.length - 1) {
-      nestedForm[key2] = value;
-    } else {
-      if (!nestedForm[key2] || typeof nestedForm[key2] !== "object" || Array.isArray(nestedForm[key2]) || nestedForm[key2] instanceof File) {
-        nestedForm[key2] = /* @__PURE__ */ Object.create(null);
-      }
-      nestedForm = nestedForm[key2];
-    }
-  });
-};
-
-// ../../node_modules/.pnpm/hono@4.12.18/node_modules/hono/dist/utils/url.js
-var tryDecode = (str, decoder) => {
-  try {
-    return decoder(str);
-  } catch {
-    return str.replace(/(?:%[0-9A-Fa-f]{2})+/g, (match2) => {
-      try {
-        return decoder(match2);
-      } catch {
-        return match2;
-      }
-    });
-  }
-};
-var _decodeURI = (value) => {
-  if (!/[%+]/.test(value)) {
-    return value;
-  }
-  if (value.indexOf("+") !== -1) {
-    value = value.replace(/\+/g, " ");
-  }
-  return value.indexOf("%") !== -1 ? tryDecode(value, decodeURIComponent_) : value;
-};
-var _getQueryParam = (url, key, multiple) => {
-  let encoded;
-  if (!multiple && key && !/[%+]/.test(key)) {
-    let keyIndex2 = url.indexOf("?", 8);
-    if (keyIndex2 === -1) {
-      return void 0;
-    }
-    if (!url.startsWith(key, keyIndex2 + 1)) {
-      keyIndex2 = url.indexOf(`&${key}`, keyIndex2 + 1);
-    }
-    while (keyIndex2 !== -1) {
-      const trailingKeyCode = url.charCodeAt(keyIndex2 + key.length + 1);
-      if (trailingKeyCode === 61) {
-        const valueIndex = keyIndex2 + key.length + 2;
-        const endIndex = url.indexOf("&", valueIndex);
-        return _decodeURI(url.slice(valueIndex, endIndex === -1 ? void 0 : endIndex));
-      } else if (trailingKeyCode == 38 || isNaN(trailingKeyCode)) {
-        return "";
-      }
-      keyIndex2 = url.indexOf(`&${key}`, keyIndex2 + 1);
-    }
-    encoded = /[%+]/.test(url);
-    if (!encoded) {
-      return void 0;
-    }
-  }
-  const results = {};
-  encoded ??= /[%+]/.test(url);
-  let keyIndex = url.indexOf("?", 8);
-  while (keyIndex !== -1) {
-    const nextKeyIndex = url.indexOf("&", keyIndex + 1);
-    let valueIndex = url.indexOf("=", keyIndex);
-    if (valueIndex > nextKeyIndex && nextKeyIndex !== -1) {
-      valueIndex = -1;
-    }
-    let name = url.slice(
-      keyIndex + 1,
-      valueIndex === -1 ? nextKeyIndex === -1 ? void 0 : nextKeyIndex : valueIndex
-    );
-    if (encoded) {
-      name = _decodeURI(name);
-    }
-    keyIndex = nextKeyIndex;
-    if (name === "") {
-      continue;
-    }
-    let value;
-    if (valueIndex === -1) {
-      value = "";
-    } else {
-      value = url.slice(valueIndex + 1, nextKeyIndex === -1 ? void 0 : nextKeyIndex);
-      if (encoded) {
-        value = _decodeURI(value);
-      }
-    }
-    if (multiple) {
-      if (!(results[name] && Array.isArray(results[name]))) {
-        results[name] = [];
-      }
-      ;
-      results[name].push(value);
-    } else {
-      results[name] ??= value;
-    }
-  }
-  return key ? results[key] : results;
-};
-var getQueryParam = _getQueryParam;
-var getQueryParams = (url, key) => {
-  return _getQueryParam(url, key, true);
-};
-var decodeURIComponent_ = decodeURIComponent;
-
-// ../../node_modules/.pnpm/hono@4.12.18/node_modules/hono/dist/request.js
-var tryDecodeURIComponent = (str) => tryDecode(str, decodeURIComponent_);
-var HonoRequest = class {
-  /**
-   * `.raw` can get the raw Request object.
-   *
-   * @see {@link https://hono.dev/docs/api/request#raw}
-   *
-   * @example
-   * ```ts
-   * // For Cloudflare Workers
-   * app.post('/', async (c) => {
-   *   const metadata = c.req.raw.cf?.hostMetadata?
-   *   ...
-   * })
-   * ```
-   */
-  raw;
-  #validatedData;
-  // Short name of validatedData
-  #matchResult;
-  routeIndex = 0;
-  /**
-   * `.path` can get the pathname of the request.
-   *
-   * @see {@link https://hono.dev/docs/api/request#path}
-   *
-   * @example
-   * ```ts
-   * app.get('/about/me', (c) => {
-   *   const pathname = c.req.path // `/about/me`
-   * })
-   * ```
-   */
-  path;
-  bodyCache = {};
-  constructor(request, path = "/", matchResult = [[]]) {
-    this.raw = request;
-    this.path = path;
-    this.#matchResult = matchResult;
-    this.#validatedData = {};
-  }
-  param(key) {
-    return key ? this.#getDecodedParam(key) : this.#getAllDecodedParams();
-  }
-  #getDecodedParam(key) {
-    const paramKey = this.#matchResult[0][this.routeIndex][1][key];
-    const param = this.#getParamValue(paramKey);
-    return param && /\%/.test(param) ? tryDecodeURIComponent(param) : param;
-  }
-  #getAllDecodedParams() {
-    const decoded = {};
-    const keys = Object.keys(this.#matchResult[0][this.routeIndex][1]);
-    for (const key of keys) {
-      const value = this.#getParamValue(this.#matchResult[0][this.routeIndex][1][key]);
-      if (value !== void 0) {
-        decoded[key] = /\%/.test(value) ? tryDecodeURIComponent(value) : value;
-      }
-    }
-    return decoded;
-  }
-  #getParamValue(paramKey) {
-    return this.#matchResult[1] ? this.#matchResult[1][paramKey] : paramKey;
-  }
-  query(key) {
-    return getQueryParam(this.url, key);
-  }
-  queries(key) {
-    return getQueryParams(this.url, key);
-  }
-  header(name) {
-    if (name) {
-      return this.raw.headers.get(name) ?? void 0;
-    }
-    const headerData = {};
-    this.raw.headers.forEach((value, key) => {
-      headerData[key] = value;
-    });
-    return headerData;
-  }
-  async parseBody(options) {
-    return parseBody(this, options);
-  }
-  #cachedBody = (key) => {
-    const { bodyCache, raw } = this;
-    const cachedBody = bodyCache[key];
-    if (cachedBody) {
-      return cachedBody;
-    }
-    const anyCachedKey = Object.keys(bodyCache)[0];
-    if (anyCachedKey) {
-      return bodyCache[anyCachedKey].then((body) => {
-        if (anyCachedKey === "json") {
-          body = JSON.stringify(body);
-        }
-        return new Response(body)[key]();
-      });
-    }
-    return bodyCache[key] = raw[key]();
-  };
-  /**
-   * `.json()` can parse Request body of type `application/json`
-   *
-   * @see {@link https://hono.dev/docs/api/request#json}
-   *
-   * @example
-   * ```ts
-   * app.post('/entry', async (c) => {
-   *   const body = await c.req.json()
-   * })
-   * ```
-   */
-  json() {
-    return this.#cachedBody("text").then((text) => JSON.parse(text));
-  }
-  /**
-   * `.text()` can parse Request body of type `text/plain`
-   *
-   * @see {@link https://hono.dev/docs/api/request#text}
-   *
-   * @example
-   * ```ts
-   * app.post('/entry', async (c) => {
-   *   const body = await c.req.text()
-   * })
-   * ```
-   */
-  text() {
-    return this.#cachedBody("text");
-  }
-  /**
-   * `.arrayBuffer()` parse Request body as an `ArrayBuffer`
-   *
-   * @see {@link https://hono.dev/docs/api/request#arraybuffer}
-   *
-   * @example
-   * ```ts
-   * app.post('/entry', async (c) => {
-   *   const body = await c.req.arrayBuffer()
-   * })
-   * ```
-   */
-  arrayBuffer() {
-    return this.#cachedBody("arrayBuffer");
-  }
-  /**
-   * Parses the request body as a `Blob`.
-   * @example
-   * ```ts
-   * app.post('/entry', async (c) => {
-   *   const body = await c.req.blob();
-   * });
-   * ```
-   * @see https://hono.dev/docs/api/request#blob
-   */
-  blob() {
-    return this.#cachedBody("blob");
-  }
-  /**
-   * Parses the request body as `FormData`.
-   * @example
-   * ```ts
-   * app.post('/entry', async (c) => {
-   *   const body = await c.req.formData();
-   * });
-   * ```
-   * @see https://hono.dev/docs/api/request#formdata
-   */
-  formData() {
-    return this.#cachedBody("formData");
-  }
-  /**
-   * Adds validated data to the request.
-   *
-   * @param target - The target of the validation.
-   * @param data - The validated data to add.
-   */
-  addValidatedData(target, data) {
-    this.#validatedData[target] = data;
-  }
-  valid(target) {
-    return this.#validatedData[target];
-  }
-  /**
-   * `.url()` can get the request url strings.
-   *
-   * @see {@link https://hono.dev/docs/api/request#url}
-   *
-   * @example
-   * ```ts
-   * app.get('/about/me', (c) => {
-   *   const url = c.req.url // `http://localhost:8787/about/me`
-   *   ...
-   * })
-   * ```
-   */
-  get url() {
-    return this.raw.url;
-  }
-  /**
-   * `.method()` can get the method name of the request.
-   *
-   * @see {@link https://hono.dev/docs/api/request#method}
-   *
-   * @example
-   * ```ts
-   * app.get('/about/me', (c) => {
-   *   const method = c.req.method // `GET`
-   * })
-   * ```
-   */
-  get method() {
-    return this.raw.method;
-  }
-  get [GET_MATCH_RESULT]() {
-    return this.#matchResult;
-  }
-  /**
-   * `.matchedRoutes()` can return a matched route in the handler
-   *
-   * @deprecated
-   *
-   * Use matchedRoutes helper defined in "hono/route" instead.
-   *
-   * @see {@link https://hono.dev/docs/api/request#matchedroutes}
-   *
-   * @example
-   * ```ts
-   * app.use('*', async function logger(c, next) {
-   *   await next()
-   *   c.req.matchedRoutes.forEach(({ handler, method, path }, i) => {
-   *     const name = handler.name || (handler.length < 2 ? '[handler]' : '[middleware]')
-   *     console.log(
-   *       method,
-   *       ' ',
-   *       path,
-   *       ' '.repeat(Math.max(10 - path.length, 0)),
-   *       name,
-   *       i === c.req.routeIndex ? '<- respond from here' : ''
-   *     )
-   *   })
-   * })
-   * ```
-   */
-  get matchedRoutes() {
-    return this.#matchResult[0].map(([[, route]]) => route);
-  }
-  /**
-   * `routePath()` can retrieve the path registered within the handler
-   *
-   * @deprecated
-   *
-   * Use routePath helper defined in "hono/route" instead.
-   *
-   * @see {@link https://hono.dev/docs/api/request#routepath}
-   *
-   * @example
-   * ```ts
-   * app.get('/posts/:id', (c) => {
-   *   return c.json({ path: c.req.routePath })
-   * })
-   * ```
-   */
-  get routePath() {
-    return this.#matchResult[0].map(([[, route]]) => route)[this.routeIndex].path;
-  }
-};
-
-// ../../node_modules/.pnpm/hono@4.12.18/node_modules/hono/dist/router/reg-exp-router/node.js
-var regExpMetaChars = new Set(".\\+*[^]$()");
-
 // src/query-builder.ts
 var QueryBuilder = class {
   constructor(collection, executor) {
@@ -472,6 +30,10 @@ var QueryBuilder = class {
     this.args.depth = depth;
     return this;
   }
+  seed(data) {
+    this.args.initialData = data;
+    return this;
+  }
   async exec() {
     return this.executor(this.collection, this.args);
   }
@@ -482,28 +44,82 @@ var QueryBuilder = class {
 };
 
 // src/index.ts
+var DyrectedError = class extends Error {
+  statusCode;
+  errors;
+  constructor(message, statusCode, errors = []) {
+    super(message);
+    this.name = "DyrectedError";
+    this.statusCode = statusCode;
+    this.errors = errors;
+  }
+};
 var DyrectedClient = class {
   baseUrl;
   headers;
   fetch;
+  defaultDepth;
   constructor(config) {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
     this.fetch = config.fetch || fetch;
+    this.defaultDepth = config.defaultDepth ?? 1;
     this.headers = {
       "Content-Type": "application/json",
-      ...config.apiKey ? { "X-API-Key": config.apiKey } : {},
+      ...config.apiKey ? { "x-api-key": config.apiKey } : {},
+      ...config.siteId ? { "x-site-id": config.siteId } : {},
       ...config.headers
     };
   }
+  /**
+   * Update the Authorization header with a Bearer token.
+   * Call this after a successful login.
+   */
+  setToken(token) {
+    this.headers["Authorization"] = `Bearer ${token}`;
+  }
+  /**
+   * Remove the Authorization header.
+   * Call this after logout.
+   */
+  clearToken() {
+    delete this.headers["Authorization"];
+  }
   getBaseUrl() {
     return this.baseUrl;
   }
   async getSchemas() {
     return this.request("/api/schemas");
   }
+  /**
+   * Fetch draft data for a specific preview token.
+   * Used in "token" preview mode.
+   */
+  async getPreviewData(token) {
+    return this.request(`/api/preview-data?token=${token}`);
+  }
   async find(collection, args = {}) {
-    const query = qs.stringify(args, { addQueryPrefix: true });
+    const { initialData, ...queryArgs } = args;
+    const normalizedArgs = { ...queryArgs };
+    if (normalizedArgs.where && typeof normalizedArgs.where === "object") {
+      normalizedArgs.where = JSON.stringify(normalizedArgs.where);
+    }
+    const query = qs.stringify(normalizedArgs, { addQueryPrefix: true });
     const res = await this.request(`/api/collections/${collection}${query}`);
+    if (res.docs.length === 0 && initialData && initialData.length > 0) {
+      this.request(`/api/collections/${collection}/seed`, {
+        method: "POST",
+        body: JSON.stringify({ data: initialData })
+      }).catch((err) => console.error(`[dyrected/sdk] Failed to auto-seed collection "${collection}":`, err));
+      return {
+        docs: initialData,
+        total: initialData.length,
+        limit: initialData.length,
+        page: 1,
+        totalPages: 1,
+        hasNextPage: false,
+        hasPrevPage: false
+      };
+    }
     return res;
   }
   /**
@@ -519,18 +135,80 @@ var DyrectedClient = class {
           if (args.limit) qb.limit(args.limit);
           if (args.page) qb.page(args.page);
           if (args.depth) qb.depth(args.depth);
+          if (args.initialData) qb.seed(args.initialData);
         }
         return qb;
       },
       findOne: (id, args = {}) => this.findOne(slug, id, args),
       create: (data) => this.create(slug, data),
       update: (id, data) => this.update(slug, id, data),
-      delete: (id) => this.delete(slug, id)
+      delete: (id) => this.delete(slug, id),
+      /**
+       * Upload a file to this collection. Sends as multipart/form-data.
+       * @param file - A File or Blob (browser) or Buffer with filename/mimeType (Node.js)
+       * @param data - Additional metadata fields to save alongside the file (e.g. alt, caption)
+       */
+      upload: (file, data) => this._upload(slug, file, data),
+      // ---- Auth methods (only meaningful when the collection has auth: true) ----
+      /**
+       * Log in with email + password. Returns a JWT token and the user document.
+       * Call `client.setToken(token)` afterwards to authenticate subsequent requests.
+       */
+      login: (email, password) => this.request(`/api/collections/${slug}/login`, {
+        method: "POST",
+        body: JSON.stringify({ email, password })
+      }),
+      /** Log out. Stateless — token must be discarded client-side; call client.clearToken() too. */
+      logout: () => this.request(`/api/collections/${slug}/logout`, { method: "POST" }),
+      /** Return the currently authenticated user (requires a token via setToken). */
+      me: () => this.request(`/api/collections/${slug}/me`),
+      /** Issue a fresh token for the currently authenticated user. */
+      refreshToken: () => this.request(`/api/collections/${slug}/refresh-token`, { method: "POST" }),
+      /** Check if this auth collection has any users (initialized). */
+      isInitialized: () => this.request(`/api/collections/${slug}/init`),
+      /** Register the very first user in an empty auth collection. */
+      registerFirstUser: (data) => this.request(`/api/collections/${slug}/first-user`, {
+        method: "POST",
+        body: JSON.stringify(data)
+      }),
+      /** Send an invitation email to a new user. Requires authentication. */
+      invite: (email) => this.request(`/api/collections/${slug}/invite`, {
+        method: "POST",
+        body: JSON.stringify({ email })
+      }),
+      /** Accept an invitation and create an account. Returns token + user. */
+      acceptInvite: (token, password, extraFields) => this.request(`/api/collections/${slug}/accept-invite`, {
+        method: "POST",
+        body: JSON.stringify({ token, password, ...extraFields })
+      })
+    };
+  }
+  /**
+   * Access a global by its slug with a fluent builder.
+   * @example client.global('site-settings').get()
+   * @example client.global('site-settings').update({ siteName: 'My Site' })
+   */
+  global(slug) {
+    return {
+      get: (args = {}) => this.getGlobal(slug, args),
+      update: (data) => this.updateGlobal(slug, data)
     };
   }
   async findOne(collection, id, args = {}) {
-    const query = qs.stringify(args, { addQueryPrefix: true });
-    return this.request(`/api/collections/${collection}/${id}${query}`);
+    const { initialData, ...queryArgs } = args;
+    const query = qs.stringify(queryArgs, { addQueryPrefix: true });
+    try {
+      return await this.request(`/api/collections/${collection}/${id}${query}`);
+    } catch (err) {
+      if (err instanceof DyrectedError && err.statusCode === 404 && initialData) {
+        this.request(`/api/collections/${collection}/seed`, {
+          method: "POST",
+          body: JSON.stringify({ data: [{ id, ...initialData }] })
+        }).catch((err2) => console.error(`[dyrected/sdk] Failed to auto-seed document "${id}" in collection "${collection}":`, err2));
+        return initialData;
+      }
+      throw err;
+    }
   }
   async create(collection, data) {
     return this.request(`/api/collections/${collection}`, {
@@ -550,8 +228,28 @@ var DyrectedClient = class {
     });
   }
   async getGlobal(slug, args = {}) {
-    const query = qs.stringify(args, { addQueryPrefix: true });
-    return this.request(`/api/globals/${slug}${query}`);
+    const { initialData, ...queryArgs } = args;
+    const query = qs.stringify(queryArgs, { addQueryPrefix: true });
+    try {
+      const res = await this.request(`/api/globals/${slug}${query}`);
+      if ((!res || Object.keys(res).length === 0) && initialData) {
+        this.request(`/api/globals/${slug}/seed`, {
+          method: "POST",
+          body: JSON.stringify({ data: initialData })
+        }).catch((err) => console.error(`[dyrected/sdk] Failed to auto-seed global "${slug}":`, err));
+        return initialData;
+      }
+      return res;
+    } catch (err) {
+      if (err instanceof DyrectedError && err.statusCode === 404 && initialData) {
+        this.request(`/api/globals/${slug}/seed`, {
+          method: "POST",
+          body: JSON.stringify({ data: initialData })
+        }).catch((err2) => console.error(`[dyrected/sdk] Failed to auto-seed global "${slug}":`, err2));
+        return initialData;
+      }
+      throw err;
+    }
   }
   async updateGlobal(slug, data) {
     return this.request(`/api/globals/${slug}`, {
@@ -559,37 +257,59 @@ var DyrectedClient = class {
       body: JSON.stringify(data)
     });
   }
-  async listMedia(args = {}) {
-    const query = qs.stringify(args, { addQueryPrefix: true });
-    return this.request(`/api/media${query}`);
+  async listMedia(args = {}, collection = "media") {
+    return this.find(collection, args);
+  }
+  /** @deprecated Use client.collection('media').upload(file, data) instead */
+  async uploadMedia(file, collection = "media") {
+    return this._upload(collection, file);
   }
-  async uploadMedia(file) {
+  /**
+   * Internal upload implementation shared by collection().upload() and uploadMedia().
+   */
+  async _upload(collection, file, data) {
     const formData = new FormData();
     formData.append("file", file);
+    if (data) {
+      for (const [key, value] of Object.entries(data)) {
+        formData.append(key, value);
+      }
+    }
     const { "Content-Type": _, ...headers } = this.headers;
-    return this.request("/api/media", {
+    return this.request(`/api/collections/${collection}`, {
       method: "POST",
-      headers,
+      headers: {
+        ...headers,
+        "Content-Type": void 0
+      },
       body: formData
     });
   }
-  async deleteMedia(id) {
-    return this.request(`/api/media/${id}`, {
-      method: "DELETE"
-    });
+  async deleteMedia(id, collection = "media") {
+    return this.delete(collection, id);
   }
   async request(path, init) {
     const url = `${this.baseUrl}${path}`;
+    const allHeaders = {
+      ...this.headers,
+      ...init?.headers
+    };
+    Object.keys(allHeaders).forEach((key) => {
+      if (allHeaders[key] === void 0) {
+        delete allHeaders[key];
+      }
+    });
     const res = await this.fetch(url, {
       ...init,
-      headers: {
-        ...this.headers,
-        ...init?.headers
-      }
+      headers: allHeaders
     });
     if (!res.ok) {
-      const error = await res.json().catch(() => ({ message: "Unknown error" }));
-      throw new Error(error.message || `Request failed with status ${res.status}`);
+      const body = await res.json().catch(() => ({ message: "Unknown error" }));
+      throw new DyrectedError(
+        body.message || `Request failed with status ${res.status}`,
+        res.status,
+        body.errors || []
+      );
     }
     return res.json();
   }
@@ -599,5 +319,6 @@ function createClient(config) {
 }
 export {
   DyrectedClient,
+  DyrectedError,
   createClient
 };