@contentrain/query 4.0.0 → 5.0.0

package/dist/generator/generate.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_generate = require("../generate-CPKYh6ZU.cjs");
+exports.generate = require_generate.generate;

package/dist/generator/generate.d.cts

@@ -0,0 +1,14 @@
+//#region src/generator/generate.d.ts
+interface GenerateOptions {
+  projectRoot: string;
+}
+interface GenerateResult {
+  generatedFiles: string[];
+  typesCount: number;
+  dataModulesCount: number;
+  packageJsonUpdated: boolean;
+}
+declare function generate(options: GenerateOptions): Promise<GenerateResult>;
+//#endregion
+export { GenerateOptions, GenerateResult, generate };
+//# sourceMappingURL=generate.d.cts.map

package/dist/generator/generate.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.cts","names":[],"sources":["../../src/generator/generate.ts"],"mappings":";UASiB,eAAA;EACf,WAAA;AAAA;AAAA,UAGe,cAAA;EACf,cAAA;EACA,UAAA;EACA,gBAAA;EACA,kBAAA;AAAA;AAAA,iBAGoB,QAAA,CAAS,OAAA,EAAS,eAAA,GAAkB,OAAA,CAAQ,cAAA"}

package/dist/generator/generate.d.mts

@@ -0,0 +1,14 @@
+//#region src/generator/generate.d.ts
+interface GenerateOptions {
+  projectRoot: string;
+}
+interface GenerateResult {
+  generatedFiles: string[];
+  typesCount: number;
+  dataModulesCount: number;
+  packageJsonUpdated: boolean;
+}
+declare function generate(options: GenerateOptions): Promise<GenerateResult>;
+//#endregion
+export { GenerateOptions, GenerateResult, generate };
+//# sourceMappingURL=generate.d.mts.map

package/dist/generator/generate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.mts","names":[],"sources":["../../src/generator/generate.ts"],"mappings":";UASiB,eAAA;EACf,WAAA;AAAA;AAAA,UAGe,cAAA;EACf,cAAA;EACA,UAAA;EACA,gBAAA;EACA,kBAAA;AAAA;AAAA,iBAGoB,QAAA,CAAS,OAAA,EAAS,eAAA,GAAkB,OAAA,CAAQ,cAAA"}

package/dist/generator/generate.mjs

@@ -0,0 +1,2 @@
+import { t as generate } from "../generate-C5Qz8qKt.mjs";
+export { generate };

package/dist/index.cjs

@@ -0,0 +1,356 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/runtime/query.ts
+var QueryBuilder = class {
+	_data;
+	_locale = null;
+	_filters = [];
+	_sortField = null;
+	_sortOrder = "asc";
+	_limit = null;
+	_offset = 0;
+	_includes = [];
+	_relationMeta;
+	_resolver;
+	_defaultLocale;
+	constructor(data, relationMeta, resolver, defaultLocale) {
+		this._data = data;
+		this._relationMeta = relationMeta ?? {};
+		this._resolver = resolver ?? null;
+		this._defaultLocale = defaultLocale ?? null;
+	}
+	locale(lang) {
+		this._locale = lang;
+		return this;
+	}
+	where(field, value) {
+		this._filters.push((item) => {
+			const v = item[field];
+			if (Array.isArray(v)) return v.includes(value);
+			return v === value;
+		});
+		return this;
+	}
+	sort(field, order = "asc") {
+		this._sortField = field;
+		this._sortOrder = order;
+		return this;
+	}
+	limit(n) {
+		this._limit = n;
+		return this;
+	}
+	offset(n) {
+		this._offset = n;
+		return this;
+	}
+	include(...fields) {
+		this._includes.push(...fields);
+		return this;
+	}
+	all() {
+		let items = this._resolveData();
+		for (const filter of this._filters) items = items.filter(filter);
+		if (this._sortField) {
+			const field = this._sortField;
+			const dir = this._sortOrder === "asc" ? 1 : -1;
+			items.sort((a, b) => {
+				const va = a[field];
+				const vb = b[field];
+				if (va == null && vb == null) return 0;
+				if (va == null) return dir;
+				if (vb == null) return -dir;
+				if (va < vb) return -dir;
+				if (va > vb) return dir;
+				return 0;
+			});
+		}
+		if (this._offset > 0 || this._limit !== null) {
+			const end = this._limit !== null ? this._offset + this._limit : void 0;
+			items = items.slice(this._offset, end);
+		}
+		if (this._includes.length > 0 && this._resolver) items = items.map((item) => this._resolveIncludes(item));
+		return items;
+	}
+	first() {
+		return this.all()[0];
+	}
+	_resolveData() {
+		if (this._locale) return [...this._data.get(this._locale) ?? []];
+		if (this._defaultLocale) {
+			const defaultData = this._data.get(this._defaultLocale);
+			if (defaultData) return [...defaultData];
+		}
+		const firstKey = this._data.keys().next().value;
+		if (firstKey !== void 0) return [...this._data.get(firstKey) ?? []];
+		return [];
+	}
+	_resolveIncludes(item) {
+		const resolved = { ...item };
+		const src = item;
+		const dst = resolved;
+		for (const field of this._includes) {
+			const meta = this._relationMeta[field];
+			if (!meta) continue;
+			const targets = Array.isArray(meta.target) ? meta.target : [meta.target];
+			if (meta.multi) {
+				const ids = src[field];
+				if (Array.isArray(ids)) dst[field] = ids.map((id) => {
+					if (typeof id === "string") return this._resolveId(targets, id) ?? id;
+					if (typeof id === "object" && id !== null && "model" in id && "ref" in id) {
+						const polyObj = id;
+						return this._resolveId([polyObj.model], polyObj.ref) ?? id;
+					}
+					return id;
+				});
+			} else {
+				const id = src[field];
+				if (typeof id === "string") dst[field] = this._resolveId(targets, id) ?? id;
+				else if (typeof id === "object" && id !== null && "model" in id && "ref" in id) {
+					const polyObj = id;
+					dst[field] = this._resolveId([polyObj.model], polyObj.ref) ?? id;
+				}
+			}
+		}
+		return resolved;
+	}
+	_resolveId(targets, id) {
+		for (const target of targets) {
+			const result = this._resolver(target, id, this._locale);
+			if (result) return result;
+		}
+	}
+};
+//#endregion
+//#region src/runtime/singleton.ts
+var SingletonAccessor = class {
+	_data;
+	_locale = null;
+	_defaultLocale;
+	_includes = [];
+	_relationMeta = {};
+	_resolveEntry;
+	constructor(data, defaultLocale, relationMeta, resolveEntry) {
+		this._data = data;
+		this._defaultLocale = defaultLocale ?? null;
+		if (relationMeta) this._relationMeta = relationMeta;
+		this._resolveEntry = resolveEntry;
+	}
+	locale(lang) {
+		this._locale = lang;
+		return this;
+	}
+	include(...fields) {
+		this._includes.push(...fields);
+		return this;
+	}
+	get() {
+		if (this._locale) {
+			const d = this._data.get(this._locale);
+			if (!d) throw new Error(`No data for locale "${this._locale}"`);
+			if (this._includes.length > 0) return this._resolveIncludes(d, this._locale);
+			return d;
+		}
+		const locale = this._defaultLocale ?? void 0;
+		let data;
+		if (locale) data = this._data.get(locale);
+		if (!data) {
+			const firstKey = this._data.keys().next().value;
+			if (firstKey !== void 0) data = this._data.get(firstKey);
+		}
+		if (!data) throw new Error("No data available");
+		if (this._includes.length > 0) return this._resolveIncludes(data, locale ?? "en");
+		return data;
+	}
+	_resolveIncludes(item, locale) {
+		if (!this._resolveEntry || this._includes.length === 0) return item;
+		const resolved = { ...item };
+		const src = item;
+		const dst = resolved;
+		for (const field of this._includes) {
+			const meta = this._relationMeta[field];
+			if (!meta) continue;
+			const targets = Array.isArray(meta.target) ? meta.target : [meta.target];
+			if (meta.multi) {
+				const ids = src[field];
+				if (Array.isArray(ids)) dst[field] = ids.map((id) => {
+					if (typeof id === "string") return this._resolveId(targets, id, locale) ?? id;
+					if (typeof id === "object" && id !== null && "model" in id && "ref" in id) {
+						const polyObj = id;
+						return this._resolveId([polyObj.model], polyObj.ref, locale) ?? id;
+					}
+					return id;
+				});
+			} else {
+				const id = src[field];
+				if (typeof id === "string") dst[field] = this._resolveId(targets, id, locale) ?? id;
+				else if (typeof id === "object" && id !== null && "model" in id && "ref" in id) {
+					const polyObj = id;
+					dst[field] = this._resolveId([polyObj.model], polyObj.ref, locale) ?? id;
+				}
+			}
+		}
+		return resolved;
+	}
+	_resolveId(targets, id, locale) {
+		if (!this._resolveEntry) return void 0;
+		for (const model of targets) {
+			const result = this._resolveEntry(model, id, locale);
+			if (result) return result;
+		}
+	}
+};
+//#endregion
+//#region src/runtime/dictionary.ts
+var DictionaryAccessor = class {
+	_data;
+	_locale = null;
+	_defaultLocale;
+	constructor(data, defaultLocale) {
+		this._data = data;
+		this._defaultLocale = defaultLocale ?? null;
+	}
+	locale(lang) {
+		this._locale = lang;
+		return this;
+	}
+	get(key, params) {
+		const dict = this._resolveData();
+		if (key === void 0) return dict;
+		const value = dict[key];
+		if (value === void 0) return void 0;
+		if (params) return interpolate(value, params);
+		return value;
+	}
+	_resolveData() {
+		if (this._locale) return this._data.get(this._locale) ?? {};
+		if (this._defaultLocale) {
+			const d = this._data.get(this._defaultLocale);
+			if (d) return d;
+		}
+		const firstKey = this._data.keys().next().value;
+		if (firstKey !== void 0) return this._data.get(firstKey) ?? {};
+		return {};
+	}
+};
+function interpolate(template, params) {
+	return template.replace(/\{(\w+)\}/g, (match, key) => {
+		const val = params[key];
+		return val !== void 0 ? String(val) : match;
+	});
+}
+//#endregion
+//#region src/runtime/document.ts
+var DocumentQuery = class {
+	_data;
+	_locale = null;
+	_filters = [];
+	_includes = [];
+	_relationMeta;
+	_resolver;
+	_defaultLocale;
+	constructor(data, relationMeta, resolver, defaultLocale) {
+		this._data = data;
+		this._relationMeta = relationMeta ?? {};
+		this._resolver = resolver ?? null;
+		this._defaultLocale = defaultLocale ?? null;
+	}
+	locale(lang) {
+		this._locale = lang;
+		return this;
+	}
+	where(field, value) {
+		this._filters.push((item) => item[field] === value);
+		return this;
+	}
+	include(...fields) {
+		this._includes.push(...fields);
+		return this;
+	}
+	bySlug(slug) {
+		const item = this._resolveData().find((i) => i["slug"] === slug);
+		if (item && this._includes.length > 0 && this._resolver) return this._resolveIncludes(item);
+		return item;
+	}
+	all() {
+		let items = this._resolveData();
+		for (const filter of this._filters) items = items.filter(filter);
+		if (this._includes.length > 0 && this._resolver) items = items.map((item) => this._resolveIncludes(item));
+		return items;
+	}
+	first() {
+		return this.all()[0];
+	}
+	_resolveData() {
+		if (this._locale) return [...this._data.get(this._locale) ?? []];
+		if (this._defaultLocale) {
+			const defaultData = this._data.get(this._defaultLocale);
+			if (defaultData) return [...defaultData];
+		}
+		const firstKey = this._data.keys().next().value;
+		if (firstKey !== void 0) return [...this._data.get(firstKey) ?? []];
+		return [];
+	}
+	_resolveIncludes(item) {
+		const resolved = { ...item };
+		const src = item;
+		const dst = resolved;
+		for (const field of this._includes) {
+			const meta = this._relationMeta[field];
+			if (!meta) continue;
+			const targets = Array.isArray(meta.target) ? meta.target : [meta.target];
+			if (meta.multi) {
+				const ids = src[field];
+				if (Array.isArray(ids)) dst[field] = ids.map((id) => {
+					if (typeof id === "string") return this._resolveId(targets, id) ?? id;
+					if (typeof id === "object" && id !== null && "model" in id && "ref" in id) {
+						const polyObj = id;
+						return this._resolveId([polyObj.model], polyObj.ref) ?? id;
+					}
+					return id;
+				});
+			} else {
+				const id = src[field];
+				if (typeof id === "string") dst[field] = this._resolveId(targets, id) ?? id;
+				else if (typeof id === "object" && id !== null && "model" in id && "ref" in id) {
+					const polyObj = id;
+					dst[field] = this._resolveId([polyObj.model], polyObj.ref) ?? id;
+				}
+			}
+		}
+		return resolved;
+	}
+	_resolveId(targets, id) {
+		for (const target of targets) {
+			const result = this._resolver(target, id, this._locale);
+			if (result) return result;
+		}
+	}
+};
+//#endregion
+//#region src/index.ts
+/**
+* Factory for framework SDK authors.
+* Returns the generated client module loaded from .contentrain/client/.
+*
+* Usage (Nuxt composable):
+* ```ts
+* import { createContentrainClient } from '@contentrain/query'
+* const client = createContentrainClient()
+* const posts = client.query('blog-post').locale('en').all()
+* ```
+*/
+async function createContentrainClient(projectRoot) {
+	const { resolve } = await import("node:path");
+	const { pathToFileURL } = await import("node:url");
+	return await import(pathToFileURL(resolve(projectRoot ?? process.cwd(), ".contentrain", "client", "index.mjs")).href);
+}
+//#endregion
+exports.DictionaryAccessor = DictionaryAccessor;
+exports.DocumentQuery = DocumentQuery;
+exports.QueryBuilder = QueryBuilder;
+exports.SingletonAccessor = SingletonAccessor;
+exports.createContentrainClient = createContentrainClient;
+exports.default = createContentrainClient;

package/dist/index.d.cts

@@ -0,0 +1,108 @@
+import { ContentStatus, ContentrainConfig, FieldDef, FieldType, ModelDefinition, ModelKind } from "@contentrain/types";
+
+//#region src/runtime/query.d.ts
+interface RelationMeta {
+  target: string | string[];
+  multi: boolean;
+}
+type RelationResolver = (model: string, id: string, locale: string | null) => Record<string, unknown> | undefined;
+declare class QueryBuilder<T extends object> {
+  private _data;
+  private _locale;
+  private _filters;
+  private _sortField;
+  private _sortOrder;
+  private _limit;
+  private _offset;
+  private _includes;
+  private _relationMeta;
+  private _resolver;
+  private _defaultLocale;
+  constructor(data: Map<string, T[]>, relationMeta?: Record<string, RelationMeta>, resolver?: RelationResolver, defaultLocale?: string);
+  locale(lang: string): this;
+  where<K extends string & keyof T>(field: K, value: T[K]): this;
+  sort<K extends string & keyof T>(field: K, order?: 'asc' | 'desc'): this;
+  limit(n: number): this;
+  offset(n: number): this;
+  include(...fields: string[]): this;
+  all(): T[];
+  first(): T | undefined;
+  private _resolveData;
+  private _resolveIncludes;
+  private _resolveId;
+}
+//#endregion
+//#region src/runtime/singleton.d.ts
+declare class SingletonAccessor<T extends Record<string, unknown>> {
+  private _data;
+  private _locale;
+  private _defaultLocale;
+  private _includes;
+  private _relationMeta;
+  private _resolveEntry?;
+  constructor(data: Map<string, T>, defaultLocale?: string, relationMeta?: Record<string, {
+    target: string | string[];
+    multi: boolean;
+  }>, resolveEntry?: (model: string, id: string, locale: string) => unknown);
+  locale(lang: string): this;
+  include(...fields: string[]): this;
+  get(): T;
+  private _resolveIncludes;
+  private _resolveId;
+}
+//#endregion
+//#region src/runtime/dictionary.d.ts
+declare class DictionaryAccessor {
+  private _data;
+  private _locale;
+  private _defaultLocale;
+  constructor(data: Map<string, Record<string, string>>, defaultLocale?: string);
+  locale(lang: string): this;
+  get(): Record<string, string>;
+  get(key: string): string | undefined;
+  get(key: string, params: Record<string, string | number>): string;
+  private _resolveData;
+}
+//#endregion
+//#region src/runtime/document.d.ts
+declare class DocumentQuery<T extends object> {
+  private _data;
+  private _locale;
+  private _filters;
+  private _includes;
+  private _relationMeta;
+  private _resolver;
+  private _defaultLocale;
+  constructor(data: Map<string, T[]>, relationMeta?: Record<string, RelationMeta>, resolver?: RelationResolver, defaultLocale?: string);
+  locale(lang: string): this;
+  where<K extends string & keyof T>(field: K, value: T[K]): this;
+  include(...fields: string[]): this;
+  bySlug(slug: string): T | undefined;
+  all(): T[];
+  first(): T | undefined;
+  private _resolveData;
+  private _resolveIncludes;
+  private _resolveId;
+}
+//#endregion
+//#region src/index.d.ts
+/**
+ * Factory for framework SDK authors.
+ * Returns the generated client module loaded from .contentrain/client/.
+ *
+ * Usage (Nuxt composable):
+ * ```ts
+ * import { createContentrainClient } from '@contentrain/query'
+ * const client = createContentrainClient()
+ * const posts = client.query('blog-post').locale('en').all()
+ * ```
+ */
+declare function createContentrainClient(projectRoot?: string): Promise<{
+  query: (model: string) => QueryBuilder<Record<string, unknown>>;
+  singleton: (model: string) => SingletonAccessor<Record<string, unknown>>;
+  dictionary: (model: string) => DictionaryAccessor;
+  document: (model: string) => DocumentQuery<Record<string, unknown>>;
+}>;
+//#endregion
+export { type ContentStatus, type ContentrainConfig, DictionaryAccessor, DocumentQuery, type FieldDef, type FieldType, type ModelDefinition, type ModelKind, QueryBuilder, type RelationMeta, type RelationResolver, SingletonAccessor, createContentrainClient, createContentrainClient as default };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/runtime/query.ts","../src/runtime/singleton.ts","../src/runtime/dictionary.ts","../src/runtime/document.ts","../src/index.ts"],"mappings":";;;UAAiB,YAAA;EACf,MAAA;EACA,KAAA;AAAA;AAAA,KAGU,gBAAA,IAAoB,KAAA,UAAe,EAAA,UAAY,MAAA,oBAA0B,MAAA;AAAA,cAExE,YAAA;EAAA,QACH,KAAA;EAAA,QACA,OAAA;EAAA,QACA,QAAA;EAAA,QACA,UAAA;EAAA,QACA,UAAA;EAAA,QACA,MAAA;EAAA,QACA,OAAA;EAAA,QACA,SAAA;EAAA,QACA,aAAA;EAAA,QACA,SAAA;EAAA,QACA,cAAA;cAGN,IAAA,EAAM,GAAA,SAAY,CAAA,KAClB,YAAA,GAAe,MAAA,SAAe,YAAA,GAC9B,QAAA,GAAW,gBAAA,EACX,aAAA;EAQF,MAAA,CAAO,IAAA;EAKP,KAAA,0BAA+B,CAAA,CAAA,CAAG,KAAA,EAAO,CAAA,EAAG,KAAA,EAAO,CAAA,CAAE,CAAA;EASrD,IAAA,0BAA8B,CAAA,CAAA,CAAG,KAAA,EAAO,CAAA,EAAG,KAAA;EAM3C,KAAA,CAAM,CAAA;EAKN,MAAA,CAAO,CAAA;EAKP,OAAA,CAAA,GAAW,MAAA;EAKX,GAAA,CAAA,GAAO,CAAA;EAsCP,KAAA,CAAA,GAAS,CAAA;EAAA,QAID,YAAA;EAAA,QAeA,gBAAA;EAAA,QAoCA,UAAA;AAAA;;;cChKG,iBAAA,WAA4B,MAAA;EAAA,QAC/B,KAAA;EAAA,QACA,OAAA;EAAA,QACA,cAAA;EAAA,QACA,SAAA;EAAA,QACA,aAAA;EAAA,QACA,aAAA;cAGN,IAAA,EAAM,GAAA,SAAY,CAAA,GAClB,aAAA,WACA,YAAA,GAAe,MAAA;IAAiB,MAAA;IAA2B,KAAA;EAAA,IAC3D,YAAA,IAAgB,KAAA,UAAe,EAAA,UAAY,MAAA;EAQ7C,MAAA,CAAO,IAAA;EAKP,OAAA,CAAA,GAAW,MAAA;EAKX,GAAA,CAAA,GAAO,CAAA;EAAA,QA4BC,gBAAA;EAAA,QAuCA,UAAA;AAAA;;;cCjGG,kBAAA;EAAA,QACH,KAAA;EAAA,QACA,OAAA;EAAA,QACA,cAAA;cAEI,IAAA,EAAM,GAAA,SAAY,MAAA,mBAAyB,aAAA;EAKvD,MAAA,CAAO,IAAA;EAKP,GAAA,CAAA,GAAO,MAAA;EACP,GAAA,CAAI,GAAA;EACJ,GAAA,CAAI,GAAA,UAAa,MAAA,EAAQ,MAAA;EAAA,QAUjB,YAAA;AAAA;;;cCzBG,aAAA;EAAA,QACH,KAAA;EAAA,QACA,OAAA;EAAA,QACA,QAAA;EAAA,QACA,SAAA;EAAA,QACA,aAAA;EAAA,QACA,SAAA;EAAA,QACA,cAAA;cAGN,IAAA,EAAM,GAAA,SAAY,CAAA,KAClB,YAAA,GAAe,MAAA,SAAe,YAAA,GAC9B,QAAA,GAAW,gBAAA,EACX,aAAA;EAQF,MAAA,CAAO,IAAA;EAKP,KAAA,0BAA+B,CAAA,CAAA,CAAG,KAAA,EAAO,CAAA,EAAG,KAAA,EAAO,CAAA,CAAE,CAAA;EAKrD,OAAA,CAAA,GAAW,MAAA;EAKX,MAAA,CAAO,IAAA,WAAe,CAAA;EAStB,GAAA,CAAA,GAAO,CAAA;EAWP,KAAA,CAAA,GAAS,CAAA;EAAA,QAID,YAAA;EAAA,QAeA,gBAAA;EAAA,QAoCA,UAAA;AAAA;;;;;AH5GV;;;;;;;;;iBIuBsB,uBAAA,CACpB,WAAA,YACC,OAAA;EACD,KAAA,GAAQ,KAAA,aAAkE,YAAA,CAAN,MAAA;EACpE,SAAA,GAAY,KAAA,aAA2E,iBAAA,CAAN,MAAA;EACjF,UAAA,GAAa,KAAA,aADmE,kBAAA;EAEhF,QAAA,GAAW,KAAA,aAAsE,aAAA,CAAN,MAAA;AAAA"}