@matvdt/js-toolkit 0.0.1-canary.2

package/README.md

@@ -0,0 +1 @@
+# js-toolkit

package/dist/chunk-CWTTD7TW.js

@@ -0,0 +1,13 @@
+// src/payload-cms/client/get-payload.ts
+import { getPayload as getPayloadSDK } from "payload";
+var getPayload = async (config) => {
+  if (config) {
+    return getPayloadSDK({ config });
+  }
+  const defaultConfig = await import("@payload-config");
+  return getPayloadSDK({ config: defaultConfig });
+};
+
+export {
+  getPayload
+};

package/dist/chunk-EZIPIKRW.js

@@ -0,0 +1,146 @@
+import {
+  getPayload
+} from "./chunk-CWTTD7TW.js";
+
+// src/payload-cms/utils/is-populated.ts
+function isPopulated(relation) {
+  return typeof relation !== "string";
+}
+
+// src/payload-cms/utils/as-populated.ts
+function asPopulated(relation) {
+  return isPopulated(relation) ? relation : void 0;
+}
+
+// src/payload-cms/utils/is-object-id.ts
+var MONGO_ID_REGEX = /^[0-9a-fA-F]{24}$/;
+function isObjectId(value) {
+  return typeof value === "string" && MONGO_ID_REGEX.test(value);
+}
+
+// src/payload-cms/utils/assert-populated.ts
+function assertPopulated(field, fieldName = "Field") {
+  if (field === null || field === void 0) {
+    throw new Error(`${fieldName} is undefined or null`);
+  }
+  if (isObjectId(field)) {
+    throw new Error(`${fieldName} is not populated (received ID: ${String(field)})`);
+  }
+}
+
+// src/payload-cms/utils/db.ts
+import { cache } from "react";
+var getClient = cache(async () => {
+  return await getPayload();
+});
+var db = {
+  findOne: async (collection, where) => {
+    const payload = await getClient();
+    const res = await payload.find({ collection, where, limit: 1 });
+    return res.docs[0] ?? null;
+  },
+  findBySlug: async (collection, slug) => {
+    return db.findOne(collection, { slug: { equals: slug } });
+  },
+  findAll: async (collection, options) => {
+    const payload = await getClient();
+    const res = await payload.find({
+      collection,
+      limit: options?.limit ?? 100,
+      ...options
+    });
+    return res.docs;
+  },
+  findByID: async (collection, id) => {
+    const payload = await getClient();
+    return payload.findByID({ collection, id });
+  },
+  create: async (collection, data, options) => {
+    const payload = await getClient();
+    return payload.create({ collection, data, ...options });
+  },
+  update: async (collection, id, data, options) => {
+    const payload = await getClient();
+    return payload.update({
+      collection,
+      id,
+      data,
+      ...options
+    });
+  },
+  updateMany: async (collection, where, data, options) => {
+    const payload = await getClient();
+    return payload.update({
+      collection,
+      where,
+      data,
+      ...options,
+      id: void 0
+    });
+  },
+  delete: async (collection, id, options) => {
+    const payload = await getClient();
+    return payload.delete({
+      collection,
+      id,
+      where: void 0,
+      ...options
+    });
+  },
+  deleteMany: async (collection, where, options) => {
+    const payload = await getClient();
+    return payload.delete({
+      collection,
+      where,
+      id: void 0,
+      ...options
+    });
+  },
+  global: async (slug) => {
+    const payload = await getClient();
+    return payload.findGlobal({ slug });
+  },
+  raw: getClient
+};
+
+// src/payload-cms/utils/create-collection.ts
+function createCollection(collection, extend) {
+  const base = {
+    findOne: (where) => db.findOne(collection, where),
+    findByID: (id) => db.findByID(collection, id),
+    findBySlug: (slug) => db.findBySlug(collection, slug),
+    findAll: (options) => db.findAll(collection, options),
+    update: (id, data, options) => db.update(collection, id, data, options),
+    updateMany: (where, data, options) => db.updateMany(collection, where, data, options),
+    delete: (id, options) => db.delete(collection, id, options),
+    deleteMany: (where, options) => db.deleteMany(collection, where, options)
+  };
+  const extended = extend ? extend(base) : void 0;
+  return {
+    ...base,
+    ...extended
+  };
+}
+
+// src/payload-cms/utils/create-global.ts
+function createGlobal(slug, extend) {
+  const base = {
+    get: () => db.global(slug)
+  };
+  const extended = extend ? extend(base) : void 0;
+  return {
+    ...base,
+    ...extended
+  };
+}
+
+export {
+  isPopulated,
+  asPopulated,
+  MONGO_ID_REGEX,
+  isObjectId,
+  assertPopulated,
+  db,
+  createCollection,
+  createGlobal
+};

package/dist/index.cjs

@@ -0,0 +1,197 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MONGO_ID_REGEX: () => MONGO_ID_REGEX,
+  asPopulated: () => asPopulated,
+  assertPopulated: () => assertPopulated,
+  createCollection: () => createCollection,
+  createGlobal: () => createGlobal,
+  db: () => db,
+  getPayload: () => getPayload,
+  isObjectId: () => isObjectId,
+  isPopulated: () => isPopulated
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/payload-cms/client/get-payload.ts
+var import_payload = require("payload");
+var getPayload = async (config) => {
+  if (config) {
+    return (0, import_payload.getPayload)({ config });
+  }
+  const defaultConfig = await import("@payload-config");
+  return (0, import_payload.getPayload)({ config: defaultConfig });
+};
+
+// src/payload-cms/utils/is-populated.ts
+function isPopulated(relation) {
+  return typeof relation !== "string";
+}
+
+// src/payload-cms/utils/as-populated.ts
+function asPopulated(relation) {
+  return isPopulated(relation) ? relation : void 0;
+}
+
+// src/payload-cms/utils/is-object-id.ts
+var MONGO_ID_REGEX = /^[0-9a-fA-F]{24}$/;
+function isObjectId(value) {
+  return typeof value === "string" && MONGO_ID_REGEX.test(value);
+}
+
+// src/payload-cms/utils/assert-populated.ts
+function assertPopulated(field, fieldName = "Field") {
+  if (field === null || field === void 0) {
+    throw new Error(`${fieldName} is undefined or null`);
+  }
+  if (isObjectId(field)) {
+    throw new Error(`${fieldName} is not populated (received ID: ${String(field)})`);
+  }
+}
+
+// src/payload-cms/utils/db.ts
+var import_react = require("react");
+var getClient = (0, import_react.cache)(async () => {
+  return await getPayload();
+});
+var db = {
+  findOne: async (collection, where) => {
+    const payload = await getClient();
+    const res = await payload.find({ collection, where, limit: 1 });
+    return res.docs[0] ?? null;
+  },
+  findBySlug: async (collection, slug) => {
+    return db.findOne(collection, { slug: { equals: slug } });
+  },
+  findAll: async (collection, options) => {
+    const payload = await getClient();
+    const res = await payload.find({
+      collection,
+      limit: options?.limit ?? 100,
+      ...options
+    });
+    return res.docs;
+  },
+  findByID: async (collection, id) => {
+    const payload = await getClient();
+    return payload.findByID({ collection, id });
+  },
+  create: async (collection, data, options) => {
+    const payload = await getClient();
+    return payload.create({ collection, data, ...options });
+  },
+  update: async (collection, id, data, options) => {
+    const payload = await getClient();
+    return payload.update({
+      collection,
+      id,
+      data,
+      ...options
+    });
+  },
+  updateMany: async (collection, where, data, options) => {
+    const payload = await getClient();
+    return payload.update({
+      collection,
+      where,
+      data,
+      ...options,
+      id: void 0
+    });
+  },
+  delete: async (collection, id, options) => {
+    const payload = await getClient();
+    return payload.delete({
+      collection,
+      id,
+      where: void 0,
+      ...options
+    });
+  },
+  deleteMany: async (collection, where, options) => {
+    const payload = await getClient();
+    return payload.delete({
+      collection,
+      where,
+      id: void 0,
+      ...options
+    });
+  },
+  global: async (slug) => {
+    const payload = await getClient();
+    return payload.findGlobal({ slug });
+  },
+  raw: getClient
+};
+
+// src/payload-cms/utils/create-collection.ts
+function createCollection(collection, extend) {
+  const base = {
+    findOne: (where) => db.findOne(collection, where),
+    findByID: (id) => db.findByID(collection, id),
+    findBySlug: (slug) => db.findBySlug(collection, slug),
+    findAll: (options) => db.findAll(collection, options),
+    update: (id, data, options) => db.update(collection, id, data, options),
+    updateMany: (where, data, options) => db.updateMany(collection, where, data, options),
+    delete: (id, options) => db.delete(collection, id, options),
+    deleteMany: (where, options) => db.deleteMany(collection, where, options)
+  };
+  const extended = extend ? extend(base) : void 0;
+  return {
+    ...base,
+    ...extended
+  };
+}
+
+// src/payload-cms/utils/create-global.ts
+function createGlobal(slug, extend) {
+  const base = {
+    get: () => db.global(slug)
+  };
+  const extended = extend ? extend(base) : void 0;
+  return {
+    ...base,
+    ...extended
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  getPayload,
+  isObjectId,
+  isPopulated
+});

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './payload-cms';

package/dist/index.js

@@ -0,0 +1,26 @@
+import "./chunk-EMH4G65N.js";
+import "./chunk-NSY6BIWE.js";
+import {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  isObjectId,
+  isPopulated
+} from "./chunk-EZIPIKRW.js";
+import {
+  getPayload
+} from "./chunk-CWTTD7TW.js";
+export {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  getPayload,
+  isObjectId,
+  isPopulated
+};

package/dist/payload-cms/client/get-payload.d.ts

@@ -0,0 +1,2 @@
+import { SanitizedConfig, type Payload } from 'payload';
+export declare const getPayload: (config?: Promise<SanitizedConfig> | SanitizedConfig) => Promise<Payload>;

package/dist/payload-cms/client/index.cjs

@@ -0,0 +1,49 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/payload-cms/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  getPayload: () => getPayload
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/payload-cms/client/get-payload.ts
+var import_payload = require("payload");
+var getPayload = async (config) => {
+  if (config) {
+    return (0, import_payload.getPayload)({ config });
+  }
+  const defaultConfig = await import("@payload-config");
+  return (0, import_payload.getPayload)({ config: defaultConfig });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getPayload
+});

package/dist/payload-cms/client/index.d.ts

@@ -0,0 +1 @@
+export * from './get-payload';

package/dist/payload-cms/client/index.js

@@ -0,0 +1,7 @@
+import "../../chunk-NSY6BIWE.js";
+import {
+  getPayload
+} from "../../chunk-CWTTD7TW.js";
+export {
+  getPayload
+};

package/dist/payload-cms/index.cjs

@@ -0,0 +1,197 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/payload-cms/index.ts
+var payload_cms_exports = {};
+__export(payload_cms_exports, {
+  MONGO_ID_REGEX: () => MONGO_ID_REGEX,
+  asPopulated: () => asPopulated,
+  assertPopulated: () => assertPopulated,
+  createCollection: () => createCollection,
+  createGlobal: () => createGlobal,
+  db: () => db,
+  getPayload: () => getPayload,
+  isObjectId: () => isObjectId,
+  isPopulated: () => isPopulated
+});
+module.exports = __toCommonJS(payload_cms_exports);
+
+// src/payload-cms/client/get-payload.ts
+var import_payload = require("payload");
+var getPayload = async (config) => {
+  if (config) {
+    return (0, import_payload.getPayload)({ config });
+  }
+  const defaultConfig = await import("@payload-config");
+  return (0, import_payload.getPayload)({ config: defaultConfig });
+};
+
+// src/payload-cms/utils/is-populated.ts
+function isPopulated(relation) {
+  return typeof relation !== "string";
+}
+
+// src/payload-cms/utils/as-populated.ts
+function asPopulated(relation) {
+  return isPopulated(relation) ? relation : void 0;
+}
+
+// src/payload-cms/utils/is-object-id.ts
+var MONGO_ID_REGEX = /^[0-9a-fA-F]{24}$/;
+function isObjectId(value) {
+  return typeof value === "string" && MONGO_ID_REGEX.test(value);
+}
+
+// src/payload-cms/utils/assert-populated.ts
+function assertPopulated(field, fieldName = "Field") {
+  if (field === null || field === void 0) {
+    throw new Error(`${fieldName} is undefined or null`);
+  }
+  if (isObjectId(field)) {
+    throw new Error(`${fieldName} is not populated (received ID: ${String(field)})`);
+  }
+}
+
+// src/payload-cms/utils/db.ts
+var import_react = require("react");
+var getClient = (0, import_react.cache)(async () => {
+  return await getPayload();
+});
+var db = {
+  findOne: async (collection, where) => {
+    const payload = await getClient();
+    const res = await payload.find({ collection, where, limit: 1 });
+    return res.docs[0] ?? null;
+  },
+  findBySlug: async (collection, slug) => {
+    return db.findOne(collection, { slug: { equals: slug } });
+  },
+  findAll: async (collection, options) => {
+    const payload = await getClient();
+    const res = await payload.find({
+      collection,
+      limit: options?.limit ?? 100,
+      ...options
+    });
+    return res.docs;
+  },
+  findByID: async (collection, id) => {
+    const payload = await getClient();
+    return payload.findByID({ collection, id });
+  },
+  create: async (collection, data, options) => {
+    const payload = await getClient();
+    return payload.create({ collection, data, ...options });
+  },
+  update: async (collection, id, data, options) => {
+    const payload = await getClient();
+    return payload.update({
+      collection,
+      id,
+      data,
+      ...options
+    });
+  },
+  updateMany: async (collection, where, data, options) => {
+    const payload = await getClient();
+    return payload.update({
+      collection,
+      where,
+      data,
+      ...options,
+      id: void 0
+    });
+  },
+  delete: async (collection, id, options) => {
+    const payload = await getClient();
+    return payload.delete({
+      collection,
+      id,
+      where: void 0,
+      ...options
+    });
+  },
+  deleteMany: async (collection, where, options) => {
+    const payload = await getClient();
+    return payload.delete({
+      collection,
+      where,
+      id: void 0,
+      ...options
+    });
+  },
+  global: async (slug) => {
+    const payload = await getClient();
+    return payload.findGlobal({ slug });
+  },
+  raw: getClient
+};
+
+// src/payload-cms/utils/create-collection.ts
+function createCollection(collection, extend) {
+  const base = {
+    findOne: (where) => db.findOne(collection, where),
+    findByID: (id) => db.findByID(collection, id),
+    findBySlug: (slug) => db.findBySlug(collection, slug),
+    findAll: (options) => db.findAll(collection, options),
+    update: (id, data, options) => db.update(collection, id, data, options),
+    updateMany: (where, data, options) => db.updateMany(collection, where, data, options),
+    delete: (id, options) => db.delete(collection, id, options),
+    deleteMany: (where, options) => db.deleteMany(collection, where, options)
+  };
+  const extended = extend ? extend(base) : void 0;
+  return {
+    ...base,
+    ...extended
+  };
+}
+
+// src/payload-cms/utils/create-global.ts
+function createGlobal(slug, extend) {
+  const base = {
+    get: () => db.global(slug)
+  };
+  const extended = extend ? extend(base) : void 0;
+  return {
+    ...base,
+    ...extended
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  getPayload,
+  isObjectId,
+  isPopulated
+});

package/dist/payload-cms/index.d.ts

@@ -0,0 +1,2 @@
+export * from './client';
+export * from './utils';

package/dist/payload-cms/index.js

@@ -0,0 +1,26 @@
+import "../chunk-EMH4G65N.js";
+import "../chunk-NSY6BIWE.js";
+import {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  isObjectId,
+  isPopulated
+} from "../chunk-EZIPIKRW.js";
+import {
+  getPayload
+} from "../chunk-CWTTD7TW.js";
+export {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  getPayload,
+  isObjectId,
+  isPopulated
+};

package/dist/payload-cms/utils/as-populated.d.ts

@@ -0,0 +1 @@
+export declare function asPopulated<T>(relation: string | T): T | undefined;

package/dist/payload-cms/utils/assert-populated.d.ts

@@ -0,0 +1 @@
+export declare function assertPopulated<T extends object>(field: string | T | null | undefined, fieldName?: string): asserts field is NonNullable<T>;

package/dist/payload-cms/utils/create-collection.d.ts

@@ -0,0 +1,13 @@
+import type { CollectionSlug, Where } from 'payload';
+import { db, DeleteOptions, FindAllOptions, UpdateData, UpdateOptions } from './db';
+export type BaseCollectionMethods<TSlug extends CollectionSlug> = {
+    findOne: (where?: Where) => ReturnType<typeof db.findOne<TSlug>>;
+    findBySlug: (slug: string) => ReturnType<typeof db.findBySlug<TSlug>>;
+    findByID: (id: string | number) => ReturnType<typeof db.findByID<TSlug>>;
+    findAll: (options?: FindAllOptions) => ReturnType<typeof db.findAll<TSlug>>;
+    update: (id: string | number, data: UpdateData, options?: UpdateOptions) => ReturnType<typeof db.update<TSlug>>;
+    updateMany: (where: Where, data: UpdateData, options?: UpdateOptions) => ReturnType<typeof db.updateMany<TSlug>>;
+    delete: (id: string | number, options?: DeleteOptions) => ReturnType<typeof db.delete<TSlug>>;
+    deleteMany: (where: Where, options?: DeleteOptions) => ReturnType<typeof db.deleteMany<TSlug>>;
+};
+export declare function createCollection<TSlug extends CollectionSlug, TExtend extends Record<string, (...args: any[]) => any> = {}>(collection: TSlug, extend?: (base: BaseCollectionMethods<TSlug>) => TExtend): BaseCollectionMethods<TSlug> & TExtend;

package/dist/payload-cms/utils/create-global.d.ts

@@ -0,0 +1,7 @@
+import type { GlobalSlug } from 'payload';
+import { db } from './db';
+type BaseGlobalMethods<TSlug extends GlobalSlug> = {
+    get: () => ReturnType<typeof db.global<TSlug>>;
+};
+export declare function createGlobal<TSlug extends GlobalSlug, TExtend extends Record<string, (...args: any[]) => any> = {}>(slug: TSlug, extend?: (base: BaseGlobalMethods<TSlug>) => TExtend): BaseGlobalMethods<TSlug> & TExtend;
+export {};

package/dist/payload-cms/utils/db.d.ts

@@ -0,0 +1,19 @@
+import type { CollectionSlug, GlobalSlug, Where } from 'payload';
+import { getPayload } from '../client/get-payload';
+export type FindAllOptions = Omit<Parameters<Awaited<ReturnType<typeof getPayload>>['find']>[0], 'collection'>;
+export type UpdateOptions = Omit<Parameters<Awaited<ReturnType<typeof getPayload>>['update']>[0], 'collection' | 'id' | 'data' | 'where'>;
+export type DeleteOptions = Omit<Parameters<Awaited<ReturnType<typeof getPayload>>['delete']>[0], 'collection' | 'id' | 'where'>;
+export type UpdateData = Parameters<Awaited<ReturnType<typeof getPayload>>['update']>[0]['data'];
+export declare const db: {
+    findOne: <TSlug extends CollectionSlug>(collection: TSlug, where?: Where) => Promise<import("payload").JsonObject & import("payload").TypeWithID>;
+    findBySlug: <TSlug extends CollectionSlug>(collection: TSlug, slug: string) => Promise<import("payload").JsonObject & import("payload").TypeWithID>;
+    findAll: <TSlug extends CollectionSlug>(collection: TSlug, options?: FindAllOptions) => Promise<(import("payload").JsonObject & import("payload").TypeWithID)[]>;
+    findByID: <TSlug extends CollectionSlug>(collection: TSlug, id: string | number) => Promise<import("payload").JsonObject & import("payload").TypeWithID>;
+    create: <TSlug extends CollectionSlug>(collection: TSlug, data: Parameters<Awaited<ReturnType<typeof getPayload>>['create']>[0]['data'], options?: Omit<Parameters<Awaited<ReturnType<typeof getPayload>>['create']>[0], 'collection' | 'data'>) => Promise<import("payload").JsonObject & import("payload").TypeWithID>;
+    update: <TSlug extends CollectionSlug>(collection: TSlug, id: string | number, data: UpdateData, options?: UpdateOptions) => Promise<import("payload").JsonObject & import("payload").TypeWithID>;
+    updateMany: <TSlug extends CollectionSlug>(collection: TSlug, where: Where, data: UpdateData, options?: UpdateOptions) => Promise<import("payload").BulkOperationResult<TSlug, import("payload").SelectExcludeType | import("payload").SelectIncludeType>>;
+    delete: <TSlug extends CollectionSlug>(collection: TSlug, id: string | number, options?: DeleteOptions) => Promise<import("payload").JsonObject & import("payload").TypeWithID>;
+    deleteMany: <TSlug extends CollectionSlug>(collection: TSlug, where: Where, options?: DeleteOptions) => Promise<import("payload").BulkOperationResult<TSlug, import("payload").SelectExcludeType | import("payload").SelectIncludeType>>;
+    global: <TSlug extends GlobalSlug>(slug: TSlug) => Promise<import("payload").JsonObject>;
+    raw: () => Promise<import("payload").BasePayload>;
+};

package/dist/payload-cms/utils/index.cjs

@@ -0,0 +1,197 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/payload-cms/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  MONGO_ID_REGEX: () => MONGO_ID_REGEX,
+  asPopulated: () => asPopulated,
+  assertPopulated: () => assertPopulated,
+  createCollection: () => createCollection,
+  createGlobal: () => createGlobal,
+  db: () => db,
+  isObjectId: () => isObjectId,
+  isPopulated: () => isPopulated
+});
+module.exports = __toCommonJS(utils_exports);
+
+// src/payload-cms/utils/is-populated.ts
+function isPopulated(relation) {
+  return typeof relation !== "string";
+}
+
+// src/payload-cms/utils/as-populated.ts
+function asPopulated(relation) {
+  return isPopulated(relation) ? relation : void 0;
+}
+
+// src/payload-cms/utils/is-object-id.ts
+var MONGO_ID_REGEX = /^[0-9a-fA-F]{24}$/;
+function isObjectId(value) {
+  return typeof value === "string" && MONGO_ID_REGEX.test(value);
+}
+
+// src/payload-cms/utils/assert-populated.ts
+function assertPopulated(field, fieldName = "Field") {
+  if (field === null || field === void 0) {
+    throw new Error(`${fieldName} is undefined or null`);
+  }
+  if (isObjectId(field)) {
+    throw new Error(`${fieldName} is not populated (received ID: ${String(field)})`);
+  }
+}
+
+// src/payload-cms/utils/db.ts
+var import_react = require("react");
+
+// src/payload-cms/client/get-payload.ts
+var import_payload = require("payload");
+var getPayload = async (config) => {
+  if (config) {
+    return (0, import_payload.getPayload)({ config });
+  }
+  const defaultConfig = await import("@payload-config");
+  return (0, import_payload.getPayload)({ config: defaultConfig });
+};
+
+// src/payload-cms/utils/db.ts
+var getClient = (0, import_react.cache)(async () => {
+  return await getPayload();
+});
+var db = {
+  findOne: async (collection, where) => {
+    const payload = await getClient();
+    const res = await payload.find({ collection, where, limit: 1 });
+    return res.docs[0] ?? null;
+  },
+  findBySlug: async (collection, slug) => {
+    return db.findOne(collection, { slug: { equals: slug } });
+  },
+  findAll: async (collection, options) => {
+    const payload = await getClient();
+    const res = await payload.find({
+      collection,
+      limit: options?.limit ?? 100,
+      ...options
+    });
+    return res.docs;
+  },
+  findByID: async (collection, id) => {
+    const payload = await getClient();
+    return payload.findByID({ collection, id });
+  },
+  create: async (collection, data, options) => {
+    const payload = await getClient();
+    return payload.create({ collection, data, ...options });
+  },
+  update: async (collection, id, data, options) => {
+    const payload = await getClient();
+    return payload.update({
+      collection,
+      id,
+      data,
+      ...options
+    });
+  },
+  updateMany: async (collection, where, data, options) => {
+    const payload = await getClient();
+    return payload.update({
+      collection,
+      where,
+      data,
+      ...options,
+      id: void 0
+    });
+  },
+  delete: async (collection, id, options) => {
+    const payload = await getClient();
+    return payload.delete({
+      collection,
+      id,
+      where: void 0,
+      ...options
+    });
+  },
+  deleteMany: async (collection, where, options) => {
+    const payload = await getClient();
+    return payload.delete({
+      collection,
+      where,
+      id: void 0,
+      ...options
+    });
+  },
+  global: async (slug) => {
+    const payload = await getClient();
+    return payload.findGlobal({ slug });
+  },
+  raw: getClient
+};
+
+// src/payload-cms/utils/create-collection.ts
+function createCollection(collection, extend) {
+  const base = {
+    findOne: (where) => db.findOne(collection, where),
+    findByID: (id) => db.findByID(collection, id),
+    findBySlug: (slug) => db.findBySlug(collection, slug),
+    findAll: (options) => db.findAll(collection, options),
+    update: (id, data, options) => db.update(collection, id, data, options),
+    updateMany: (where, data, options) => db.updateMany(collection, where, data, options),
+    delete: (id, options) => db.delete(collection, id, options),
+    deleteMany: (where, options) => db.deleteMany(collection, where, options)
+  };
+  const extended = extend ? extend(base) : void 0;
+  return {
+    ...base,
+    ...extended
+  };
+}
+
+// src/payload-cms/utils/create-global.ts
+function createGlobal(slug, extend) {
+  const base = {
+    get: () => db.global(slug)
+  };
+  const extended = extend ? extend(base) : void 0;
+  return {
+    ...base,
+    ...extended
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  isObjectId,
+  isPopulated
+});

package/dist/payload-cms/utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './as-populated';
+export * from './assert-populated';
+export * from './create-collection';
+export * from './create-global';
+export * from './db';
+export * from './is-object-id';
+export * from './is-populated';

package/dist/payload-cms/utils/index.js

@@ -0,0 +1,21 @@
+import {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  isObjectId,
+  isPopulated
+} from "../../chunk-EZIPIKRW.js";
+import "../../chunk-CWTTD7TW.js";
+export {
+  MONGO_ID_REGEX,
+  asPopulated,
+  assertPopulated,
+  createCollection,
+  createGlobal,
+  db,
+  isObjectId,
+  isPopulated
+};

package/dist/payload-cms/utils/is-object-id.d.ts

@@ -0,0 +1,2 @@
+export declare const MONGO_ID_REGEX: RegExp;
+export declare function isObjectId(value: unknown): value is string;

package/dist/payload-cms/utils/is-populated.d.ts

@@ -0,0 +1 @@
+export declare function isPopulated<T>(relation: string | T): relation is T;

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@matvdt/js-toolkit",
+  "version": "0.0.1-canary.2",
+  "description": "JS/TS toolkit",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./payload-cms": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup && tsc",
+    "publish:canary": "npm publish --access public --tag canary",
+    "publish:alpha" : "npm publish --access public --tag alpha",
+    "publish:beta"  : "npm publish --access public --tag beta",
+    "publish:rc"    : "npm publish --access public --tag rc",
+    "publish:latest": "npm publish --access public",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "toolkit",
+    "javascript"
+  ],
+  "author": "Matteo Vidotto",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.1.2",
+    "@types/react": "^19.2.17",
+    "payload": "^3.86.0",
+    "react": "^19.2.8",
+    "tsup": "^8.5.1",
+    "typescript": "^7.0.2"
+  },
+  "peerDependencies": {
+    "payload": ">=3.0.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "payload": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  }
+}