@levo-so/core 0.1.113 → 0.3.7

package/README.md

@@ -256,8 +256,4 @@ const query: LevoQuery.FindQuery = {
 
 **`getLevoError(error)`** — Normalize any thrown value into a `LevoError`. See [Error Handling](#error-handling).
 
-**`formatImagePath(path)`** — URI-encodes the filename portion of a path. Use this when constructing image URLs that may contain spaces or special characters.
-
-**`listToColumn(arr)`** — Converts `["name", "email"]` into `{ name: "name", email: "email" }`. Useful for building field selection objects programmatically.
-
 **Type utilities** — `Prettify<T>`, `Mandatory<T, K>`, and `DeepPartial<T>` are exported from the package for use in consuming packages that build on top of `@levo-so/core`.

package/dist/index.d.ts

@@ -2,6 +2,12 @@ import { QueryStringAddon } from 'wretch/addons/queryString';
 import { Wretch } from 'wretch';
 import { WretchOptions } from 'wretch';
 
+export declare const allMediaFileExtensions: string[];
+
+export declare const allMediaMimetypes: {
+    [x: string]: string[];
+};
+
 export declare const AnalyticsEvents: {
     "bevy.collection.filled": "bevy.collection.filled";
     "bevy.collection.submitted": "bevy.collection.submitted";
@@ -34,6 +40,14 @@ export declare const AnalyticsEventsList: readonly ["bevy.collection.filled", "b
 
 export declare type AnalyticsEventType = (typeof AnalyticsEventsList)[number];
 
+export declare const audioFileExtensions: string[];
+
+export declare const audioMimetype: {
+    "audio/mpeg": string[];
+    "audio/ogg": string[];
+    "audio/opus": string[];
+};
+
 export declare namespace BlogClient {
     export interface CoverImage {
         _id: string;
@@ -204,6 +218,10 @@ export declare const createLevoClient: (options: ILevoClientOptions) => {
         submitDraftEntry: (collection_key: string, data: any) => Promise<IResponseSingle<IDraftEntry>>;
         getFilters: (collectionId: string, options?: WretchOptions) => Promise<IResponseMultiple<ILemaCollection["sections"][number]["fields"][number]>>;
     };
+    readonly event: {
+        getAllEvents: (series_key: string, data?: import("./types").LevoQuery.FindQuery, options?: import("./types").BlogClient.OptionParams) => Promise<IResponseMultiple<import("./types").LevoEvent.Root>>;
+        getSingleEvent: (slug: string, options?: import("./types").BlogClient.OptionParams) => Promise<IResponseSingle<import("./types").LevoEvent.Root>>;
+    };
     readonly media: {
         mediaBulkUpload: (formData: FormData, options?: WretchOptions, context?: IMediaUploadContext) => Promise<IResponseMultiple<IMedia>>;
         getAllMedia: (data?: import("./types").LevoQuery.FindQuery) => Promise<IResponseMultiple<IMedia>>;
@@ -266,6 +284,19 @@ export declare const defaultByKinds: Record<(typeof FieldKindList)[number], any>
  */
 export declare const defineLevoLoggerMiddleware: (name: string, callback: (core: ILevoControl, level: LogLevel, args: any[]) => void) => ILevoLoggerMiddleware;
 
+export declare const documentFileExtensions: string[];
+
+export declare const documentMimetype: {
+    "application/xml": string[];
+    "text/plain": string[];
+    "application/pdf": string[];
+    "application/msword": string[];
+    "application/vnd.ms-excel": string[];
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": string[];
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document": string[];
+    "text/csv": string[];
+};
+
 export declare type FieldFilter<T extends string = string> = Partial<Record<T, ComparableFilter<T> | FieldType>>;
 
 export declare const FieldInterfaces: Record<"TextWidget" | "CurrencyWidget" | "TextareaWidget" | "GeocoderWidget" | "MultiGeocoderWidget" | "DropdownWidget" | "ToggleCheckboxWidget" | "RadioWidget" | "NumberWidget" | "EmailWidget" | "PhoneWidget" | "URLWidget" | "DateWidget" | "TimeWidget" | "SwitchWidget" | "RichTextWidget" | "DateTimeWidget" | "CheckboxWidget" | "ImageUploadWidget" | "MultiImageUploadWidget" | "FileUploadWidget" | "MultiFileUploadWidget" | "MultiDropdownWidget" | "MultiTextWidget" | "CollectionWidget" | "ArrayWidget" | "RecordWidget" | "JSONWidget" | "SlugWidget", "TextWidget" | "CurrencyWidget" | "TextareaWidget" | "GeocoderWidget" | "MultiGeocoderWidget" | "DropdownWidget" | "ToggleCheckboxWidget" | "RadioWidget" | "NumberWidget" | "EmailWidget" | "PhoneWidget" | "URLWidget" | "DateWidget" | "TimeWidget" | "SwitchWidget" | "RichTextWidget" | "DateTimeWidget" | "CheckboxWidget" | "ImageUploadWidget" | "MultiImageUploadWidget" | "FileUploadWidget" | "MultiFileUploadWidget" | "MultiDropdownWidget" | "MultiTextWidget" | "CollectionWidget" | "ArrayWidget" | "RecordWidget" | "JSONWidget" | "SlugWidget">;
@@ -303,8 +334,6 @@ export declare type FieldType = string | number | Date | boolean | null;
 
 export declare type Filter<T extends string = string> = LogicalFilter<T> | FieldFilter<T>;
 
-export declare const formatImagePath: (string: string) => string;
-
 export declare const formatsByInterface: Record<(typeof FieldInterfacesList)[number], string[]>;
 
 export declare const FORUM_POST_KIND: {
@@ -759,6 +788,8 @@ export declare interface IField {
     hidden?: boolean;
     /** Whether the field is editable. */
     editable?: boolean;
+    /** Rank of the field within its section. Defaults to 0 server-side when omitted. */
+    sort_order?: number;
     /** Whether the field is required. */
     required?: boolean;
     /** Whether the field value must be unique. */
@@ -1412,6 +1443,19 @@ export declare interface ILogicRule {
     when: LogicWhen;
 }
 
+export declare const imageFileExtensions: string[];
+
+export declare const imageMimetype: {
+    "image/jpeg": string[];
+    "image/jpg": string[];
+    "image/png": string[];
+    "image/gif": string[];
+    "image/svg": string[];
+    "image/svg+xml": string[];
+    "image/webp": string[];
+    "image/avif": string[];
+};
+
 export declare interface IMe {
     _id: string;
     public_id: string;
@@ -1467,6 +1511,33 @@ export declare type IMediaObject = Pick<IMedia, "id" | "location" | "srcset" | "
     mimetype?: IMedia["metadata"]["mimetype"];
 };
 
+/**
+ * Live storage-usage aggregate for a workspace, from `GET /v1/assets/media/storage`.
+ * Computed fresh from the `media_storage` table on every call (not the cached, drifting
+ * `assets.media_size` counter). Root figures plus a per-`kind` breakdown.
+ */
+export declare interface IMediaStorage extends IMediaStorageMetrics {
+    workspace_id: string;
+    /**
+     * Per-media-type breakdown. All five keys are always present, zero-filled when empty,
+     * and the buckets sum exactly to the root totals.
+     */
+    kind: Record<IMediaStorageKind, IMediaStorageMetrics>;
+}
+
+/** Media types the storage endpoint groups by. `unknown` = orphaned/blank-kind rows. */
+export declare type IMediaStorageKind = "image" | "video" | "audio" | "document" | "unknown";
+
+/** The three storage figures, at the root and inside each `kind` bucket. Sizes are raw bytes. */
+export declare interface IMediaStorageMetrics {
+    /** File count — every stored file, incl. resize variants (images only). Not a size. */
+    total_files: number;
+    /** `SUM(size_in_bytes)` in raw bytes. */
+    total_size: number;
+    /** Mean bytes per file, rounded to a whole byte. */
+    average_size: number;
+}
+
 /** Source context attached to a media upload so the backend can record where the file originated. */
 export declare interface IMediaUploadContext {
     /** The product module the upload belongs to (e.g. "community", "blog"). */
@@ -1868,6 +1939,14 @@ export declare interface IWorkspace {
         };
         /** Whether user has an existing website or is creating new */
         website_status?: "existing" | "new";
+        /** Presence of this is what makes the API stamp `onboarded_at`. */
+        site_type?: IWorkspaceSiteType;
+        role?: IWorkspaceRole;
+        org_size?: IWorkspaceOrgSize;
+        website?: string;
+        brand?: IWorkspaceBrandInfo;
+        /** Extracted business-description document, attached after the workspace exists. */
+        description_document_id?: string;
     };
     settings: {
         head_code?: string;
@@ -1883,6 +1962,26 @@ export declare interface IWorkspace {
     subscription: ISubscription | null;
 }
 
+/** Brand identity scraped from the user's live site at signup. */
+export declare interface IWorkspaceBrandInfo {
+    name?: string | null;
+    description?: string | null;
+    category?: string | null;
+    logo_url?: string | null;
+    favicon_url?: string | null;
+    colors?: string[];
+}
+
+export declare type IWorkspaceOrgSize = "just-me" | "2-10" | "11-50" | "51-500" | "501-5000" | "5001+";
+
+export declare type IWorkspaceRole = "founder" | "marketing" | "sales" | "designer" | "content" | "engineering" | "agency" | "other";
+
+/**
+ * v3 PLG onboarding (`/welcome`) segmentation. The API validates these members —
+ * see issue #4521 — so they are unions, not free-form strings.
+ */
+export declare type IWorkspaceSiteType = "b2b-saas" | "manufacturer" | "service" | "dealer-portal" | "membership" | "other";
+
 declare type JSONContent = {
     type?: string;
     attrs?: Record<string, any>;
@@ -2225,8 +2324,6 @@ export declare namespace LevoQuery {
     }>;
 }
 
-export declare const listToColumn: <T extends string>(columns: readonly string[]) => Record<T, string>;
-
 export declare const listToRecord: <T extends string>(columns: readonly string[]) => { [K in T]: K; };
 
 export declare type LogicAction = "show" | "hide";
@@ -2284,10 +2381,14 @@ export declare enum LogLevel {
 
 export declare type Mandatory<T, K extends keyof T> = Prettify<Pick<T, K> & Partial<Omit<T, K>>>;
 
+export declare const mediaExtensionsByKind: Record<(typeof MediaKindList)[number], string[]>;
+
 export declare const MediaKind: Record<"image" | "video" | "audio" | "document", "image" | "video" | "audio" | "document">;
 
 export declare const MediaKindList: readonly ["image", "video", "audio", "document"];
 
+export declare const mediaMimetypeByKind: Record<(typeof MediaKindList)[number], Record<string, string[]>>;
+
 /** Reject types assignable to Error — forces `{ exception }` wrapping at the call site. */
 declare type NotError<T> = T extends Error ? never : T;
 
@@ -2305,6 +2406,14 @@ export declare type Prettify<T> = {
  */
 export declare const remoteLoggerMiddleware: (options: IRemoteLoggerMiddlewareOptions) => ILevoLoggerMiddleware;
 
+export declare const videoFileExtensions: string[];
+
+export declare const videoMimetype: {
+    "video/mp4": string[];
+    "video/mpeg": string[];
+    "video/webm": string[];
+};
+
 export declare type WithinFilterType = {
     latitude: number;
     longitude: number;

package/dist/index.js

@@ -296,21 +296,28 @@ var r = /^W[A-Z0-9]{7}$/, i = (e) => {
 	getFilters: async (e, n = {}) => t.instance.url(`/v1/bevy/collection/${e}/get-filters`).options(n).get().json().then((e) => e).catch((e) => {
 		throw g(e);
 	})
-}), y = 600 * 1e3, b = (e, t) => ({
+}), y = (e, t) => ({
+	getAllEvents: async (e, n = {}, r) => t.instance.url(`/v1/event/event/${e}/event/query`).query({ ...r?.params || {} }).options({ headers: { "Levo-Workspace": r?.workspace_id || void 0 } }).post(n).json().then((e) => e).catch((e) => {
+		throw g(e);
+	}),
+	getSingleEvent: async (e, n) => t.instance.url(`/v1/event/event/${e}/get-single-event`).query({ ...n?.params || {} }).options({ headers: { "Levo-Workspace": n?.workspace_id || void 0 } }).get().json().then((e) => e).catch((e) => {
+		throw g(e);
+	})
+}), b = 600 * 1e3, x = (e, t) => ({
 	mediaBulkUpload: async (e, n = {}, r) => {
 		let i = { ...n };
-		return delete i.signal, t.getInstance(y).url("/v1/assets/media/bulk").query(r ?? {}).options(i).post(e).json().then((e) => e).catch((e) => {
+		return delete i.signal, t.getInstance(b).url("/v1/assets/media/bulk").query(r ?? {}).options(i).post(e).json().then((e) => e).catch((e) => {
 			throw g(e);
 		});
 	},
 	getAllMedia: async (e = {}) => t.instance.url("/v1/assets/media/query").post(e).json().then((e) => e).catch((e) => {
 		throw g(e);
 	})
-}), x = [
+}), S = [
 	"google",
 	"linkedin",
 	"microsoft"
-], S = (e, t) => {
+], C = (e, t) => {
 	let n = async (n = {}) => t.instance.url("/v1/membership/auth/oauth/get-redirect-url").options(n).get().json().then((n) => {
 		let r = n?.content?.data, i = Object.keys(r);
 		if (typeof window < "u") for (let n of i) {
@@ -321,7 +328,7 @@ var r = /^W[A-Z0-9]{7}$/, i = (e) => {
 			}
 		}
 		return r;
-	}).catch(() => x.reduce((e, t) => (e[t] = null, e), {})), r = async (e = {}) => t.instance.url("/v1/membership/auth/sign-out").options(e).post("").json().then((e) => e?.content?.data).catch((e) => {
+	}).catch(() => S.reduce((e, t) => (e[t] = null, e), {})), r = async (e = {}) => t.instance.url("/v1/membership/auth/sign-out").options(e).post("").json().then((e) => e?.content?.data).catch((e) => {
 		throw g(e);
 	}), i = async (e = {}) => t.instance.url("/v1/membership/auth/get-me").options(e).get().json().then((e) => e?.content?.data).catch((e) => {
 		throw g(e);
@@ -353,12 +360,12 @@ var r = /^W[A-Z0-9]{7}$/, i = (e) => {
 			throw g(e);
 		})
 	};
-}, C = (e) => {
+}, w = (e) => {
 	let { pageContext: t = {
 		url: typeof window < "u" ? window?.location?.href : "",
 		referrer: typeof document < "u" ? document?.referrer : "",
 		title: typeof document < "u" ? document?.title : ""
-	}, loggerOptions: n = {}, ...r } = e, a = t, s = i(r), c = o(s, a), l = _(s, c), u = S(s, c), d = v(s, c), f = b(s, c), m = p(s, n);
+	}, loggerOptions: n = {}, ...r } = e, a = t, s = i(r), c = o(s, a), l = _(s, c), u = C(s, c), d = v(s, c), f = y(s, c), m = x(s, c), h = p(s, n);
 	return {
 		get apiUrl() {
 			return s.apiUrl;
@@ -375,12 +382,15 @@ var r = /^W[A-Z0-9]{7}$/, i = (e) => {
 		get collection() {
 			return d;
 		},
-		get media() {
+		get event() {
 			return f;
 		},
-		get logger() {
+		get media() {
 			return m;
 		},
+		get logger() {
+			return h;
+		},
 		get fetch() {
 			return c.instance;
 		},
@@ -400,7 +410,7 @@ var r = /^W[A-Z0-9]{7}$/, i = (e) => {
 			s.workspace = e;
 		}
 	};
-}, w = {
+}, ee = {
 	"public-id": "",
 	string: "",
 	number: null,
@@ -563,11 +573,87 @@ var r = /^W[A-Z0-9]{7}$/, i = (e) => {
 	CollectionWidget: M.collection,
 	JSONWidget: M.json
 }, P = [
+	"pdf",
+	"txt",
+	"xml",
+	"xls",
+	"xlsx",
+	"ods",
+	"odt",
+	"doc",
+	"docx",
+	"csv",
+	"odp",
+	"ppt",
+	"pptx"
+], F = [
+	"svg",
+	"png",
+	"jpg",
+	"jpeg",
+	"gif",
+	"webp",
+	"avif"
+], I = [
+	"mp4",
+	"ogv",
+	"webm"
+], L = [
+	"mp3",
+	"ogg",
+	"opus"
+], R = {
+	"application/xml": [".xml"],
+	"text/plain": [".txt"],
+	"application/pdf": [".pdf"],
+	"application/msword": [".doc"],
+	"application/vnd.ms-excel": [".xls"],
+	"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": [".xlsx"],
+	"application/vnd.openxmlformats-officedocument.wordprocessingml.document": [".docx"],
+	"text/csv": [".csv"]
+}, z = {
+	"image/jpeg": [".jpeg", ".jpg"],
+	"image/jpg": [".jpg"],
+	"image/png": [".png"],
+	"image/gif": [".gif"],
+	"image/svg": [".svg"],
+	"image/svg+xml": [".svg"],
+	"image/webp": [".webp"],
+	"image/avif": [".avif"]
+}, B = {
+	"video/mp4": [".mp4"],
+	"video/mpeg": [".mpeg"],
+	"video/webm": [".webm"]
+}, V = {
+	"audio/mpeg": [".mp3"],
+	"audio/ogg": [".oga"],
+	"audio/opus": [".opus"]
+}, H = {
+	audio: V,
+	document: R,
+	image: z,
+	video: B
+}, U = {
+	audio: L,
+	document: P,
+	image: F,
+	video: I
+}, W = [
+	...U.audio,
+	...U.document,
+	...U.image,
+	...U.video
+], G = {
+	...H.audio,
+	...H.document,
+	...H.image,
+	...H.video
+}, K = [
 	"image",
 	"video",
 	"audio",
 	"document"
-], F = P.reduce((e, t) => (e[t] = t, e), {}), I = (e) => e.reduce((e, t) => (e[t] = t, e), {}), L = (e) => e.reduce((e, t) => (e[t] = t, e), {}), R = [
+], q = K.reduce((e, t) => (e[t] = t, e), {}), J = (e) => e.reduce((e, t) => (e[t] = t, e), {}), Y = [
 	"bevy.collection.filled",
 	"bevy.collection.submitted",
 	"bevy.collection.view",
@@ -593,7 +679,7 @@ var r = /^W[A-Z0-9]{7}$/, i = (e) => {
 	"page.selection",
 	"user.active",
 	"user.idle"
-], z = L(R), B = (e) => e.module_name ? "module" : e.allow_public_submit && !e.public_submit_set_by ? "form" : "collection", V = {
+], X = J(Y), Z = (e) => e.module_name ? "module" : e.allow_public_submit && !e.public_submit_set_by ? "form" : "collection", Q = {
 	string: [
 		"equals",
 		"not",
@@ -660,31 +746,24 @@ var r = /^W[A-Z0-9]{7}$/, i = (e) => {
 	identifier: ["equals", "not"],
 	record: [],
 	group: []
-}, H = {
+}, te = {
 	published: "published",
 	unpublished: "unpublished",
 	archived: "archived",
 	flagged: "flagged",
 	pending_moderation: "pending_moderation"
-}, U = {
+}, $ = {
 	post: "post",
 	poll: "poll",
 	gallery: "gallery",
 	link: "link"
-}, W = Object.keys(U), G = {
+}, ne = Object.keys($), re = {
 	draft: "draft",
 	published: "published",
 	unpublished: "unpublished",
 	archived: "archived",
 	flagged: "flagged",
 	pending_moderation: "pending_moderation"
-}, K = (e) => {
-	let t = e.split("/"), n = t[t.length - 1];
-	if (n) {
-		let t = encodeURIComponent(n);
-		return e.replace(n, t);
-	}
-	return "";
 };
 //#endregion
-export { z as AnalyticsEvents, R as AnalyticsEventsList, H as COMMENT_STATUS, k as CommonFieldIntefaces, E as CommonFieldInterfacesList, D as ComplexFieldInterfacesList, U as FORUM_POST_KIND, G as FORUM_POST_STATUS, A as FieldInterfaces, O as FieldInterfacesList, M as FieldKind, j as FieldKindList, W as ForumPostKindExpandedList, m as LevoError, x as LevoOAuthProviderList, d as LogLevel, F as MediaKind, P as MediaKindList, C as createLevoClient, p as createLevoLogger, w as defaultByKinds, f as defineLevoLoggerMiddleware, K as formatImagePath, T as formatsByInterface, B as getCollectionKind, g as getLevoError, N as interfaceKinds, I as listToColumn, L as listToRecord, V as operatorsByKind, u as remoteLoggerMiddleware };
+export { X as AnalyticsEvents, Y as AnalyticsEventsList, te as COMMENT_STATUS, k as CommonFieldIntefaces, E as CommonFieldInterfacesList, D as ComplexFieldInterfacesList, $ as FORUM_POST_KIND, re as FORUM_POST_STATUS, A as FieldInterfaces, O as FieldInterfacesList, M as FieldKind, j as FieldKindList, ne as ForumPostKindExpandedList, m as LevoError, S as LevoOAuthProviderList, d as LogLevel, q as MediaKind, K as MediaKindList, W as allMediaFileExtensions, G as allMediaMimetypes, L as audioFileExtensions, V as audioMimetype, w as createLevoClient, p as createLevoLogger, ee as defaultByKinds, f as defineLevoLoggerMiddleware, P as documentFileExtensions, R as documentMimetype, T as formatsByInterface, Z as getCollectionKind, g as getLevoError, F as imageFileExtensions, z as imageMimetype, N as interfaceKinds, J as listToRecord, U as mediaExtensionsByKind, H as mediaMimetypeByKind, Q as operatorsByKind, u as remoteLoggerMiddleware, I as videoFileExtensions, B as videoMimetype };

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@levo-so/core",
   "description": "Levo common utilities",
-  "version": "0.1.113",
+  "version": "0.3.7",
   "author": "Levo Engineering <devs@theinternetfolks.com>",
   "dependencies": {
-    "lodash-es": "4.18.1",
     "wretch": "2.9.0"
   },
   "devDependencies": {
-    "@types/lodash-es": "4.17.12",
     "typescript": "5.9.3",
     "vite": "8.0.8",
     "vite-plugin-dts": "4.5.4",