content-query 0.3.0 → 0.5.0

package/dist/operators-UqWUhKQJ.mjs

@@ -1,173 +0,0 @@
-import { a as invalidQuery } from "./errors-C2iuBM0G.mjs";
-import { c as isScalar, i as detach } from "./values-BbTV4QT-.mjs";
-//#region src/query/operators.ts
-/** Builds a checked, backend-independent predicate instead of a per-entry callback. */
-function predicate(operator, field, value) {
-	if (!field || typeof field.name !== "string" || !field.name) invalidQuery("A filter must reference a query field.");
-	if ([
-		"in-array",
-		"not-in-array",
-		"array-contains-any",
-		"array-contains-all",
-		"array-contained"
-	].includes(operator)) {
-		if (!Array.isArray(value) || !value.every(isScalar)) invalidQuery("Choice arguments must be arrays of scalar values.");
-	} else if ([
-		"contains",
-		"starts-with",
-		"ends-with",
-		"like",
-		"ilike"
-	].includes(operator)) {
-		if (typeof value !== "string") invalidQuery("String predicates require a string argument.");
-	} else if (!operator.startsWith("is-") && !isScalar(value)) invalidQuery("This predicate requires a scalar argument.");
-	if ([
-		"gt",
-		"gte",
-		"lt",
-		"lte"
-	].includes(operator) && (value == null || typeof value === "boolean")) invalidQuery("Range predicates require a string, number, bigint, or date.");
-	return {
-		kind: "predicate",
-		operator,
-		field: field.name,
-		value: detach(value)
-	};
-}
-/** Matches a scalar using strict value/date equality. */
-function eq(field, value) {
-	return predicate("eq", field, value);
-}
-/** Negates scalar equality. */
-function ne(field, value) {
-	return predicate("ne", field, value);
-}
-/** Matches values greater than the supplied scalar. */
-function gt(field, value) {
-	return predicate("gt", field, value);
-}
-/** Matches values greater than or equal to the supplied scalar. */
-function gte(field, value) {
-	return predicate("gte", field, value);
-}
-/** Matches values less than the supplied scalar. */
-function lt(field, value) {
-	return predicate("lt", field, value);
-}
-/** Matches values less than or equal to the supplied scalar. */
-function lte(field, value) {
-	return predicate("lte", field, value);
-}
-/** Matches one of a list of scalar choices. */
-function inArray(field, values) {
-	return predicate("in-array", field, values);
-}
-/** Matches none of a list of scalar choices. */
-function notInArray(field, values) {
-	return predicate("not-in-array", field, values);
-}
-/** Matches a literal substring, without SQL wildcard interpretation. */
-function contains(field, value) {
-	return predicate("contains", field, value);
-}
-/** Matches a literal string prefix. */
-function startsWith(field, value) {
-	return predicate("starts-with", field, value);
-}
-/** Matches a literal string suffix. */
-function endsWith(field, value) {
-	return predicate("ends-with", field, value);
-}
-/** Tests scalar membership in an array, ignoring holes. */
-function arrayContains(field, value) {
-	return predicate("array-contains", field, value);
-}
-/** Tests whether any candidate belongs to an existing scalar array. */
-function arrayContainsAny(field, values) {
-	return predicate("array-contains-any", field, values);
-}
-/** Tests whether every candidate belongs to an existing scalar array. */
-function arrayContainsAll(field, values) {
-	return predicate("array-contains-all", field, values);
-}
-/** Checks explicit null independently from undefined and absence. */
-function isNull(field) {
-	return predicate("is-null", field);
-}
-/** Checks undefined, including a missing property. */
-function isUndefined(field) {
-	return predicate("is-undefined", field);
-}
-/** Checks own-property absence before projection. */
-function isMissing(field) {
-	return predicate("is-missing", field);
-}
-/** Requires all child predicates; an empty conjunction is true. */
-function and(...expressions) {
-	expressions.forEach(validateExpression);
-	return {
-		kind: "and",
-		expressions
-	};
-}
-/** Requires any child predicate; an empty disjunction is false. */
-function or(...expressions) {
-	expressions.forEach(validateExpression);
-	return {
-		kind: "or",
-		expressions
-	};
-}
-/** Negates a predicate's boolean result. */
-function not(expression) {
-	validateExpression(expression);
-	return {
-		kind: "not",
-		expressions: [expression]
-	};
-}
-/** Checks the shape of expression trees even when TypeScript was bypassed. */
-function validateExpression(expression) {
-	if (!expression || typeof expression !== "object") invalidQuery("where() must return a structured expression.");
-	if (expression.kind === "predicate") {
-		if (![
-			"eq",
-			"ne",
-			"gt",
-			"gte",
-			"lt",
-			"lte",
-			"in-array",
-			"not-in-array",
-			"contains",
-			"starts-with",
-			"ends-with",
-			"like",
-			"ilike",
-			"array-contains",
-			"array-contains-any",
-			"array-contains-all",
-			"array-contained",
-			"is-null",
-			"is-undefined",
-			"is-missing"
-		].includes(expression.operator)) invalidQuery("Unknown filter operator.");
-		predicate(expression.operator, { name: expression.field }, expression.value);
-	} else if (expression.kind === "relation") {
-		if ([
-			expression.collection,
-			expression.field,
-			expression.target
-		].some((name) => typeof name !== "string" || !name)) invalidQuery("Relationship filters require registered collection and relationship names.");
-		validateExpression(expression.expression);
-	} else if ([
-		"and",
-		"or",
-		"not"
-	].includes(expression.kind) && Array.isArray(expression.expressions)) {
-		if (expression.kind === "not" && expression.expressions.length !== 1) invalidQuery("not() requires one expression.");
-		expression.expressions.forEach(validateExpression);
-	} else invalidQuery("Invalid expression structure.");
-}
-//#endregion
-export { not as _, contains as a, startsWith as b, gt as c, isMissing as d, isNull as f, ne as g, lte as h, arrayContainsAny as i, gte as l, lt as m, arrayContains as n, endsWith as o, isUndefined as p, arrayContainsAll as r, eq as s, and as t, inArray as u, notInArray as v, validateExpression as x, or as y };

package/dist/types-BC8gVJ6u.d.mts

@@ -1,69 +0,0 @@
-import { o as Loader } from "./types-FmUJ3cH1.mjs";
-import { n as ContentRenderResult } from "./types-Dh-Sydyw.mjs";
-import { StandardSchemaV1 } from "@standard-schema/spec";
-//#region src/collection/types.d.ts
-declare const builtinPayloadsType: unique symbol;
-type Schema = StandardSchemaV1;
-type SchemaOutput<Value> = Value extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<Value> : Record<string, unknown>;
-type ComputedContext<Data, Source = unknown> = {
-  /** The collection's key in the configured registry. */
-  collection: string;
-  id: string;
-  /** Loader-provided source metadata, detached from stored entries for this resolver. */
-  source?: Source extends object ? Readonly<Source> : Source;
-  data: Readonly<Data>;
-  readBody(this: void): Promise<string | undefined>;
-  signal: AbortSignal;
-};
-type ComputedDefinition<Data = Record<string, unknown>, Source = unknown> = {
-  schema: Schema;
-  resolve(context: ComputedContext<Data, Source>): unknown;
-};
-type Relationship = {
-  collection: string;
-  type: "one" | "many";
-  from: string;
-  to: string;
-  referenceSide: "from" | "to" | "none";
-};
-type CollectionDefinition<SourceSchema extends Schema | undefined = Schema | undefined, Computed extends Record<string, ComputedDefinition<never, never>> = Record<string, ComputedDefinition<never, never>>, Relationships extends Record<string, Relationship> = Record<string, Relationship>> = {
-  loader: Loader;
-  schema?: SourceSchema;
-  computed?: Computed;
-  relationships?: Relationships;
-};
-type CollectionRegistry = Record<string, CollectionDefinition>;
-type EntryData<Definition> = Definition extends {
-  schema: infer SourceSchema;
-} ? SchemaOutput<SourceSchema> : Record<string, unknown>;
-type ComputedData<Definition> = Definition extends {
-  computed: infer Computed;
-} ? { [Name in keyof Computed]: Computed[Name] extends {
-  schema: infer ResultSchema;
-} ? SchemaOutput<ResultSchema> : never; } : {};
-type QueryData<Definition> = {
-  id: string;
-} & EntryData<Definition> & ComputedData<Definition>;
-type RelationshipsOf<Definition> = Definition extends {
-  relationships: infer Relationships;
-} ? Relationships : {};
-/**
- * Payloads that Markdown sources, `glob()`, and custom loaders provide for every entry.
- * Built-in names start with an underscore, so they never collide with custom payloads.
- */
-type BuiltinPayloads = {
-  /** The retained raw body, or undefined when the entry has none or retention is disabled. */
-  _body: string | undefined;
-  /** HTML and headings; entries without a rendering path reject with `not-renderable`. */
-  _rendered: ContentRenderResult;
-};
-/** Type-only marker recording which built-in payloads a defined collection carries. */
-type BuiltinPayloadMarker<Available extends keyof BuiltinPayloads> = {
-  readonly [builtinPayloadsType]?: Available;
-};
-/** Payload names and value types that queries can request for a collection definition. */
-type PayloadsOf<Definition> = Definition extends {
-  readonly [builtinPayloadsType]?: infer Available;
-} ? Pick<BuiltinPayloads, Available & keyof BuiltinPayloads> : BuiltinPayloads;
-//#endregion
-export { ComputedContext as a, Relationship as c, SchemaOutput as d, CollectionRegistry as i, RelationshipsOf as l, BuiltinPayloads as n, PayloadsOf as o, CollectionDefinition as r, QueryData as s, BuiltinPayloadMarker as t, Schema as u };

package/dist/validation-D_XdE1pF.mjs

@@ -1,84 +0,0 @@
-import { n as contentError, t as ContentError } from "./errors-C2iuBM0G.mjs";
-import { i as detach } from "./values-BbTV4QT-.mjs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-//#region src/loaders/descriptor.ts
-const builtinSymbol = Symbol.for("content-query.builtin-loader");
-/** Finds library-owned loader settings without depending on module instance identity. */
-function builtinLoader(loader) {
-	return loader[builtinSymbol];
-}
-/** Resolves a loader's watch root from the application root, including file URLs. */
-function builtinPath(descriptor, root) {
-	if (descriptor.kind === "file") return path.resolve(root, descriptor.filename);
-	return descriptor.options.base instanceof URL ? path.resolve(fileURLToPath(descriptor.options.base)) : path.resolve(root, descriptor.options.base ?? ".");
-}
-//#endregion
-//#region src/preparation/validation.ts
-/** Checks records independently from validation-provider schema introspection. */
-function isRecord(value) {
-	return !!value && typeof value === "object" && !Array.isArray(value) && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
-}
-/** Validates one result, retaining structured provider issues and their original detail. */
-async function validate(schema, value, context) {
-	if (!schema) return value;
-	try {
-		const result = await schema["~standard"].validate(value);
-		if (result.issues) {
-			const firstPath = result.issues[0]?.path?.map((segment) => typeof segment === "object" ? segment.key : segment);
-			throw new ContentError({
-				...context,
-				code: "validation-error",
-				message: result.issues.map((issue) => issue.message).join("; "),
-				issues: result.issues,
-				path: [...context.path ?? [], ...firstPath ?? []]
-			});
-		}
-		return result.value;
-	} catch (cause) {
-		throw contentError(cause, {
-			...context,
-			code: "validation-error",
-			message: "Schema validation failed."
-		});
-	}
-}
-/** Checks loader transport structure and rejects duplicate snapshot/upsert identities. */
-function normalizeSnapshot(entries, collection) {
-	if (!Array.isArray(entries)) throw new ContentError({
-		code: "source-error",
-		collection,
-		message: "load() must return an array of structured entries."
-	});
-	const snapshot = /* @__PURE__ */ new Map();
-	for (const entry of entries) {
-		if (!entry || typeof entry.id !== "string" || !entry.id || !isRecord(entry.data) || entry.body !== void 0 && typeof entry.body !== "string" || entry.source !== void 0 && typeof entry.source !== "string") throw new ContentError({
-			code: "source-error",
-			collection,
-			id: entry && typeof entry === "object" && typeof entry.id === "string" ? entry.id : void 0,
-			source: entry && typeof entry === "object" && typeof entry.source === "string" ? entry.source : void 0,
-			message: "Invalid structured loader entry."
-		});
-		if (snapshot.has(entry.id)) throw new ContentError({
-			code: "duplicate-id",
-			collection,
-			id: entry.id,
-			source: entry.source,
-			message: `Duplicate entry ID "${entry.id}".`
-		});
-		snapshot.set(entry.id, entry);
-	}
-	return snapshot;
-}
-/** Validates supplied rendering data and normalizes omitted headings. */
-function renderedPayload(entry) {
-	if (entry.rendered === void 0) return;
-	const rendered = entry.rendered;
-	if (!rendered || typeof rendered.html !== "string" || rendered.metadata !== void 0 && (!isRecord(rendered.metadata) || rendered.metadata.headings !== void 0 && (!Array.isArray(rendered.metadata.headings) || rendered.metadata.headings.some((heading) => !heading || !Number.isInteger(heading.depth) || heading.depth < 1 || heading.depth > 6 || typeof heading.slug !== "string" || typeof heading.text !== "string")))) throw new Error("Invalid supplied HTML/headings payload.");
-	return {
-		html: rendered.html,
-		headings: detach(rendered.metadata?.headings ?? [])
-	};
-}
-//#endregion
-export { builtinLoader as a, validate as i, normalizeSnapshot as n, builtinPath as o, renderedPayload as r, builtinSymbol as s, isRecord as t };