@kywi-software/core 0.1.0

package/dist/db/component-queries.js

@@ -0,0 +1,146 @@
+import { eq, and } from 'drizzle-orm';
+import { kywiComponents } from '../schema/components.js';
+import { kywiSectionTemplates } from '../schema/base.js';
+// ── CRUD ─────────────────────────────────────────────────────────────────────
+export async function createComponent(db, data) {
+    const [row] = await db
+        .insert(kywiComponents)
+        .values({
+        siteId: data.siteId,
+        name: data.name,
+        description: data.description ?? null,
+        type: data.type,
+        moduleType: data.moduleType ?? null,
+        definition: data.definition,
+        createdBy: data.createdBy ?? null,
+    })
+        .returning();
+    return row;
+}
+// Item-level queries take an OPTIONAL siteId scope. kywi_components /
+// kywi_section_templates rows are addressable by UUID, so a query with no siteId
+// predicate lets an admin scoped to one site read/mutate another site's item by
+// id. When siteId is provided the predicate is ANDed in (foreign id → null).
+export async function updateComponent(db, id, data, siteId) {
+    const [row] = await db
+        .update(kywiComponents)
+        .set({ ...data, updatedAt: new Date() })
+        .where(siteId === undefined
+        ? eq(kywiComponents.id, id)
+        : and(eq(kywiComponents.id, id), eq(kywiComponents.siteId, siteId)))
+        .returning();
+    return row ?? null;
+}
+export async function deleteComponent(db, id, siteId) {
+    const [row] = await db
+        .delete(kywiComponents)
+        .where(siteId === undefined
+        ? eq(kywiComponents.id, id)
+        : and(eq(kywiComponents.id, id), eq(kywiComponents.siteId, siteId)))
+        .returning({ id: kywiComponents.id });
+    return row !== undefined;
+}
+export async function getComponentById(db, id, siteId) {
+    const [row] = await db
+        .select()
+        .from(kywiComponents)
+        .where(siteId === undefined
+        ? eq(kywiComponents.id, id)
+        : and(eq(kywiComponents.id, id), eq(kywiComponents.siteId, siteId)))
+        .limit(1);
+    return row ?? null;
+}
+export async function listComponents(db, siteId, type) {
+    if (type) {
+        return db
+            .select()
+            .from(kywiComponents)
+            .where(and(eq(kywiComponents.siteId, siteId), eq(kywiComponents.type, type)));
+    }
+    return db
+        .select()
+        .from(kywiComponents)
+        .where(eq(kywiComponents.siteId, siteId));
+}
+// ── Resolve / Disconnect ─────────────────────────────────────────────────────
+/**
+ * Resolve the effective props for a module node.
+ * If the node is linked to a component, merge component props (base) with
+ * node inline props (overrides). Otherwise return the node's own props.
+ */
+export function resolveModuleProps(node, component) {
+    if (!node.componentId || !component)
+        return node.props;
+    const componentProps = component.definition.props ?? {};
+    return { ...componentProps, ...node.props };
+}
+/**
+ * Disconnect a module node from its component by copying the resolved props
+ * into the node and removing the componentId link.
+ */
+export function disconnectFromComponent(node, component) {
+    const resolved = resolveModuleProps(node, component);
+    // Drop the componentId link; omit the key rather than setting it to
+    // undefined so the node satisfies ModuleNode under exactOptionalPropertyTypes.
+    const { componentId: _componentId, ...rest } = node;
+    return {
+        ...rest,
+        props: resolved,
+    };
+}
+// ── Section Template CRUD ───────────────────────────────────────
+export async function createSectionTemplate(db, data) {
+    const [row] = await db
+        .insert(kywiSectionTemplates)
+        .values({
+        siteId: data.siteId,
+        name: data.name,
+        category: data.category ?? 'general',
+        definition: data.definition,
+        createdBy: data.createdBy ?? null,
+    })
+        .returning();
+    return row;
+}
+export async function getSectionTemplateById(db, id, siteId) {
+    const [row] = await db
+        .select()
+        .from(kywiSectionTemplates)
+        .where(siteId === undefined
+        ? eq(kywiSectionTemplates.id, id)
+        : and(eq(kywiSectionTemplates.id, id), eq(kywiSectionTemplates.siteId, siteId)))
+        .limit(1);
+    return row ?? null;
+}
+export async function listSectionTemplates(db, siteId, category) {
+    if (category) {
+        return db
+            .select()
+            .from(kywiSectionTemplates)
+            .where(and(eq(kywiSectionTemplates.siteId, siteId), eq(kywiSectionTemplates.category, category)));
+    }
+    return db
+        .select()
+        .from(kywiSectionTemplates)
+        .where(eq(kywiSectionTemplates.siteId, siteId));
+}
+export async function updateSectionTemplate(db, id, data, siteId) {
+    const [row] = await db
+        .update(kywiSectionTemplates)
+        .set({ ...data, updatedAt: new Date() })
+        .where(siteId === undefined
+        ? eq(kywiSectionTemplates.id, id)
+        : and(eq(kywiSectionTemplates.id, id), eq(kywiSectionTemplates.siteId, siteId)))
+        .returning();
+    return row ?? null;
+}
+export async function deleteSectionTemplate(db, id, siteId) {
+    const [row] = await db
+        .delete(kywiSectionTemplates)
+        .where(siteId === undefined
+        ? eq(kywiSectionTemplates.id, id)
+        : and(eq(kywiSectionTemplates.id, id), eq(kywiSectionTemplates.siteId, siteId)))
+        .returning({ id: kywiSectionTemplates.id });
+    return row !== undefined;
+}
+//# sourceMappingURL=component-queries.js.map

package/dist/db/component-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-queries.js","sourceRoot":"","sources":["../../src/db/component-queries.ts"],"names":[],"mappings":"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"}

package/dist/db/content-locking.d.ts

@@ -0,0 +1,17 @@
+import type { KywiDb } from './client.js';
+/**
+ * Lock a content item (isLocked = true).
+ * Returns true if a row was updated.
+ */
+export declare function lockContent(db: KywiDb, contentId: string, _userId: string): Promise<boolean>;
+/**
+ * Unlock a content item (isLocked = false).
+ * Returns true if a row was updated.
+ */
+export declare function unlockContent(db: KywiDb, contentId: string): Promise<boolean>;
+/**
+ * Check whether a content item is locked.
+ * Returns false if the content item does not exist.
+ */
+export declare function isContentLocked(db: KywiDb, contentId: string): Promise<boolean>;
+//# sourceMappingURL=content-locking.d.ts.map

package/dist/db/content-locking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-locking.d.ts","sourceRoot":"","sources":["../../src/db/content-locking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;GAGG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlG;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrF"}

package/dist/db/content-locking.js

@@ -0,0 +1,39 @@
+import { eq } from 'drizzle-orm';
+import { kywiContent } from '../schema/base.js';
+/**
+ * Lock a content item (isLocked = true).
+ * Returns true if a row was updated.
+ */
+export async function lockContent(db, contentId, _userId) {
+    const [row] = await db
+        .update(kywiContent)
+        .set({ isLocked: true })
+        .where(eq(kywiContent.id, contentId))
+        .returning({ id: kywiContent.id });
+    return row !== undefined;
+}
+/**
+ * Unlock a content item (isLocked = false).
+ * Returns true if a row was updated.
+ */
+export async function unlockContent(db, contentId) {
+    const [row] = await db
+        .update(kywiContent)
+        .set({ isLocked: false })
+        .where(eq(kywiContent.id, contentId))
+        .returning({ id: kywiContent.id });
+    return row !== undefined;
+}
+/**
+ * Check whether a content item is locked.
+ * Returns false if the content item does not exist.
+ */
+export async function isContentLocked(db, contentId) {
+    const [row] = await db
+        .select({ isLocked: kywiContent.isLocked })
+        .from(kywiContent)
+        .where(eq(kywiContent.id, contentId))
+        .limit(1);
+    return row?.isLocked ?? false;
+}
+//# sourceMappingURL=content-locking.js.map

package/dist/db/content-locking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-locking.js","sourceRoot":"","sources":["../../src/db/content-locking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU,EAAE,SAAiB,EAAE,OAAe;IAC9E,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE;SACnB,MAAM,CAAC,WAAW,CAAC;SACnB,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;SACvB,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;SACpC,SAAS,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAA;IACpC,OAAO,GAAG,KAAK,SAAS,CAAA;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAU,EAAE,SAAiB;IAC/D,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE;SACnB,MAAM,CAAC,WAAW,CAAC;SACnB,GAAG,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;SACxB,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;SACpC,SAAS,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAA;IACpC,OAAO,GAAG,KAAK,SAAS,CAAA;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAU,EAAE,SAAiB;IACjE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE;SACnB,MAAM,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC;SAC1C,IAAI,CAAC,WAAW,CAAC;SACjB,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;SACpC,KAAK,CAAC,CAAC,CAAC,CAAA;IACX,OAAO,GAAG,EAAE,QAAQ,IAAI,KAAK,CAAA;AAC/B,CAAC"}

package/dist/db/content-permission-queries.d.ts

@@ -0,0 +1,28 @@
+import type { KywiContentPermissionRow, NewKywiContentPermission } from '../schema/content-permissions.js';
+import type { KywiDb } from './client.js';
+/**
+ * Grant a permission on a content item to a user or group.
+ * Provide either userId or groupId (not both).
+ */
+export declare function grantContentPermission(db: KywiDb, data: Omit<NewKywiContentPermission, 'id' | 'createdAt'>): Promise<KywiContentPermissionRow>;
+/**
+ * Revoke a permission by its ID.
+ * Returns true if a row was deleted, false if it did not exist.
+ */
+export declare function revokeContentPermission(db: KywiDb, permissionId: string): Promise<boolean>;
+/**
+ * List all permissions for a given content item.
+ */
+export declare function listContentPermissions(db: KywiDb, contentId: string): Promise<KywiContentPermissionRow[]>;
+/**
+ * Check whether a user has a specific action permission on a content item.
+ * Resolves permission directly (userId match) or via group membership (groupId in userGroupIds).
+ * Returns true if any matching permission row exists.
+ */
+export declare function checkUserContentPermission(db: KywiDb, contentId: string, userId: string, userGroupIds: string[], action: string): Promise<boolean>;
+/**
+ * Remove all permissions for a given content item.
+ * Useful when deleting content or resetting access rules.
+ */
+export declare function clearContentPermissions(db: KywiDb, contentId: string): Promise<void>;
+//# sourceMappingURL=content-permission-queries.d.ts.map

package/dist/db/content-permission-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-permission-queries.d.ts","sourceRoot":"","sources":["../../src/db/content-permission-queries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAA;AAC1G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,WAAW,CAAC,GACvD,OAAO,CAAC,wBAAwB,CAAC,CAOnC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAKrC;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/db/content-permission-queries.js

@@ -0,0 +1,61 @@
+import { eq, and, or, inArray } from 'drizzle-orm';
+import { kywiContentPermissions } from '../schema/content-permissions.js';
+/**
+ * Grant a permission on a content item to a user or group.
+ * Provide either userId or groupId (not both).
+ */
+export async function grantContentPermission(db, data) {
+    const [row] = await db
+        .insert(kywiContentPermissions)
+        .values(data)
+        .returning();
+    if (!row)
+        throw new Error('Failed to grant content permission');
+    return row;
+}
+/**
+ * Revoke a permission by its ID.
+ * Returns true if a row was deleted, false if it did not exist.
+ */
+export async function revokeContentPermission(db, permissionId) {
+    const [deleted] = await db
+        .delete(kywiContentPermissions)
+        .where(eq(kywiContentPermissions.id, permissionId))
+        .returning();
+    return deleted !== undefined;
+}
+/**
+ * List all permissions for a given content item.
+ */
+export async function listContentPermissions(db, contentId) {
+    return db
+        .select()
+        .from(kywiContentPermissions)
+        .where(eq(kywiContentPermissions.contentId, contentId));
+}
+/**
+ * Check whether a user has a specific action permission on a content item.
+ * Resolves permission directly (userId match) or via group membership (groupId in userGroupIds).
+ * Returns true if any matching permission row exists.
+ */
+export async function checkUserContentPermission(db, contentId, userId, userGroupIds, action) {
+    const userOrGroupCondition = userGroupIds.length > 0
+        ? or(eq(kywiContentPermissions.userId, userId), inArray(kywiContentPermissions.groupId, userGroupIds))
+        : eq(kywiContentPermissions.userId, userId);
+    const [row] = await db
+        .select({ id: kywiContentPermissions.id })
+        .from(kywiContentPermissions)
+        .where(and(eq(kywiContentPermissions.contentId, contentId), eq(kywiContentPermissions.action, action), userOrGroupCondition))
+        .limit(1);
+    return row !== undefined;
+}
+/**
+ * Remove all permissions for a given content item.
+ * Useful when deleting content or resetting access rules.
+ */
+export async function clearContentPermissions(db, contentId) {
+    await db
+        .delete(kywiContentPermissions)
+        .where(eq(kywiContentPermissions.contentId, contentId));
+}
+//# sourceMappingURL=content-permission-queries.js.map

package/dist/db/content-permission-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-permission-queries.js","sourceRoot":"","sources":["../../src/db/content-permission-queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AAIzE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,EAAU,EACV,IAAwD;IAExD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE;SACnB,MAAM,CAAC,sBAAsB,CAAC;SAC9B,MAAM,CAAC,IAAI,CAAC;SACZ,SAAS,EAAE,CAAA;IACd,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAC/D,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,EAAU,EACV,YAAoB;IAEpB,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE;SACvB,MAAM,CAAC,sBAAsB,CAAC;SAC9B,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;SAClD,SAAS,EAAE,CAAA;IACd,OAAO,OAAO,KAAK,SAAS,CAAA;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,EAAU,EACV,SAAiB;IAEjB,OAAO,EAAE;SACN,MAAM,EAAE;SACR,IAAI,CAAC,sBAAsB,CAAC;SAC5B,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAA;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,EAAU,EACV,SAAiB,EACjB,MAAc,EACd,YAAsB,EACtB,MAAc;IAEd,MAAM,oBAAoB,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC;QAClD,CAAC,CAAC,EAAE,CACA,EAAE,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,CAAC,sBAAsB,CAAC,OAAO,EAAE,YAAY,CAAC,CACtD;QACH,CAAC,CAAC,EAAE,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE7C,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE;SACnB,MAAM,CAAC,EAAE,EAAE,EAAE,sBAAsB,CAAC,EAAE,EAAE,CAAC;SACzC,IAAI,CAAC,sBAAsB,CAAC;SAC5B,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,sBAAsB,CAAC,SAAS,EAAE,SAAS,CAAC,EAC/C,EAAE,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,oBAAoB,CACrB,CACF;SACA,KAAK,CAAC,CAAC,CAAC,CAAA;IAEX,OAAO,GAAG,KAAK,SAAS,CAAA;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,EAAU,EACV,SAAiB;IAEjB,MAAM,EAAE;SACL,MAAM,CAAC,sBAAsB,CAAC;SAC9B,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAA;AAC3D,CAAC"}

package/dist/db/content-queries.d.ts

@@ -0,0 +1,98 @@
+import { eq } from 'drizzle-orm';
+import type { PgTableWithColumns } from 'drizzle-orm/pg-core';
+import type { KywiDb } from './client.js';
+import type { ContentTypeConfig } from '../config/types.js';
+import type { PaginationParams, SortParams, FilterParams } from '../api/pagination.js';
+/**
+ * Build SQL conditions that exclude content outside its display window.
+ *
+ * displayStart: content hidden before this timestamp (null = no lower bound)
+ * displayStop:  content hidden on/after this timestamp (null = no upper bound)
+ */
+export declare function buildDisplayWindowConditions(now?: Date): (import("drizzle-orm").SQL<unknown> | undefined)[];
+export type ContentWithCustomFields = Record<string, unknown>;
+/**
+ * Merge a kywi_content row with its custom field table row into a flat object.
+ * Removes the duplicate id/siteId from the custom fields.
+ *
+ * When `customTable` is provided, every declared custom field is present in the
+ * result (null when unset), so consumers can rely on a stable shape regardless
+ * of whether a custom-field row was ever written for this node.
+ */
+export declare function mergeContentRow(base: Record<string, unknown>, custom: Record<string, unknown> | null, customTable?: PgTableWithColumns<any> | null): ContentWithCustomFields;
+/**
+ * Split an input record into base table fields and custom field table fields.
+ */
+export declare function splitCustomFields(input: Record<string, unknown>, customFieldNames: string[]): {
+    baseFields: Record<string, unknown>;
+    customFields: Record<string, unknown>;
+};
+/**
+ * Build Drizzle conditions for custom field equality filters.
+ * Returns an empty array if no custom table or no fields to filter.
+ */
+export declare function buildCustomFieldConditions(customFields: Record<string, string>, customTable: PgTableWithColumns<any> | null): ReturnType<typeof eq>[];
+/**
+ * List content nodes with pagination, filtering, and sorting.
+ */
+export declare function listContent(db: KywiDb, contentType: ContentTypeConfig, customTable: PgTableWithColumns<any> | null, siteId: string, pagination: PaginationParams, sort: SortParams, filters: FilterParams, visibleStatuses?: string[]): Promise<{
+    rows: ContentWithCustomFields[];
+    total: number;
+}>;
+/**
+ * Get a single content node by ID, joined with custom fields.
+ *
+ * Item-level lookup takes an OPTIONAL siteId scope. kywi_content rows are
+ * addressable by UUID, so callers with a request site context (the admin
+ * content routes) MUST pass it: without a siteId predicate an admin scoped to
+ * one site can read/mutate another site's content by id. When siteId is provided
+ * the predicate is ANDed in (foreign id → null). Internal/public read callers
+ * that already resolved the site by other means may omit it.
+ */
+export declare function getContentById(db: KywiDb, customTable: PgTableWithColumns<any> | null, id: string, siteId?: string): Promise<ContentWithCustomFields | null>;
+/**
+ * Get a single content node by slug path.
+ * Optionally filter by locale; when no locale match is found the query
+ * returns whatever row matches the slug+site (default locale fallback).
+ */
+export declare function getContentBySlug(db: KywiDb, customTable: PgTableWithColumns<any> | null, slug: string, siteId: string, options?: {
+    locale?: string;
+}): Promise<ContentWithCustomFields | null>;
+/**
+ * Create a new content node with custom fields.
+ */
+export declare function createContent(db: KywiDb, contentType: ContentTypeConfig, customTable: PgTableWithColumns<any> | null, siteId: string, data: Record<string, unknown>, userId: string | null): Promise<ContentWithCustomFields>;
+/**
+ * Update a content node and its custom fields.
+ */
+export declare function updateContent(db: KywiDb, contentType: ContentTypeConfig, customTable: PgTableWithColumns<any> | null, id: string, data: Record<string, unknown>, userId: string | null): Promise<ContentWithCustomFields | null>;
+/**
+ * Soft-delete a content node (set deletedAt).
+ */
+export declare function deleteContent(db: KywiDb, id: string, siteId?: string): Promise<boolean>;
+/**
+ * Publish a content node. Stamps publishedAt the first time only — COALESCE
+ * keeps an existing timestamp so re-publishing preserves the original date.
+ *
+ * `siteId` is an optional cross-site guard (see deleteContent): when provided,
+ * an id from another site resolves to null and the route returns 404.
+ */
+export declare function publishContent(db: KywiDb, id: string, siteId?: string): Promise<ContentWithCustomFields | null>;
+/**
+ * Unpublish a content node. publishedAt is deliberately left intact — the
+ * first-published date is history and must survive an unpublish.
+ *
+ * `siteId` is an optional cross-site guard (see deleteContent): when provided,
+ * an id from another site resolves to null and the route returns 404.
+ */
+export declare function unpublishContent(db: KywiDb, id: string, siteId?: string): Promise<ContentWithCustomFields | null>;
+/**
+ * Restore a soft-deleted content node (clear deletedAt).
+ */
+export declare function restoreContent(db: KywiDb, id: string): Promise<boolean>;
+/**
+ * Permanently delete a soft-deleted content node.
+ * Only works on rows that already have deletedAt set.
+ */
+export declare function permanentDeleteContent(db: KywiDb, id: string, siteId?: string): Promise<boolean>;
+//# sourceMappingURL=content-queries.d.ts.map

package/dist/db/content-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-queries.d.ts","sourceRoot":"","sources":["../../src/db/content-queries.ts"],"names":[],"mappings":"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"}