@kywi-software/core 0.1.0

package/dist/db/dynamic-schema.js

@@ -0,0 +1,48 @@
+import { pgTable, uuid, text, varchar, boolean, numeric, jsonb, timestamp, } from 'drizzle-orm/pg-core';
+import { camelToSnake, contentTypeToTableName } from '../schema/mapper.js';
+function fieldToColumn(field) {
+    const colName = camelToSnake(field.name);
+    switch (field.type) {
+        case 'text':
+        case 'richText':
+        case 'textarea':
+            return text(colName);
+        case 'select':
+        case 'slug':
+            return varchar(colName, { length: 255 });
+        case 'color':
+            return varchar(colName, { length: 7 });
+        case 'multiSelect':
+        case 'json':
+        case 'group':
+            return jsonb(colName);
+        case 'relationship':
+        case 'image':
+        case 'file':
+            return uuid(colName);
+        case 'date':
+            return timestamp(colName, { withTimezone: true });
+        case 'boolean':
+            return field.required === false
+                ? boolean(colName)
+                : boolean(colName).notNull().default(false);
+        case 'number':
+            return numeric(colName);
+        default: {
+            const _exhaustive = field.type;
+            return text(colName);
+        }
+    }
+}
+export function buildCustomFieldTable(contentType) {
+    const tableName = contentTypeToTableName(contentType.name);
+    const columns = {
+        id: uuid('id').primaryKey(),
+        siteId: uuid('site_id').notNull(),
+    };
+    for (const field of contentType.fields) {
+        columns[field.name] = fieldToColumn(field);
+    }
+    return pgTable(tableName, columns);
+}
+//# sourceMappingURL=dynamic-schema.js.map

package/dist/db/dynamic-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-schema.js","sourceRoot":"","sources":["../../src/db/dynamic-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,EACP,OAAO,EACP,KAAK,EACL,SAAS,GACV,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAE1E,SAAS,aAAa,CAAC,KAAsB;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAExC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,OAAO,CAAC,CAAA;QACtB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QAC1C,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;QACxC,KAAK,aAAa,CAAC;QACnB,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,CAAA;QACvB,KAAK,cAAc,CAAC;QACpB,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,OAAO,CAAC,CAAA;QACtB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,QAAQ,KAAK,KAAK;gBAC7B,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;gBAClB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC/C,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,OAAO,CAAC,CAAA;QACzB,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,KAAK,CAAC,IAAI,CAAA;YACrC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAA;QACtB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,WAA8B;IAE9B,MAAM,SAAS,GAAG,sBAAsB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAE1D,MAAM,OAAO,GAAwB;QACnC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;QAC3B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;KAClC,CAAA;IAED,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AACpC,CAAC"}

package/dist/db/env-guard.d.ts

@@ -0,0 +1,31 @@
+/** Redact credentials from a connection string before showing it to the user. */
+export declare function redactDbUrl(url: string | undefined): string;
+/**
+ * Turn a database connection/query error into a friendly, actionable message,
+ * or return null when the error is not a recognised connection problem (so the
+ * caller can rethrow the original).
+ */
+export declare function explainDbError(err: unknown, dbUrl?: string): string | null;
+/**
+ * Resolve the effective database URL, or throw a friendly error when NOTHING
+ * provides one (no config.db.url and no DATABASE_URL). Returns the url plus
+ * where it came from so callers can warn on a silent fallback.
+ */
+export declare function resolveDatabaseUrl(configUrl: string | undefined, fallback?: string): {
+    url: string;
+    source: 'config' | 'env' | 'fallback';
+};
+/**
+ * Resolve the auth secret with a fail-fast policy: in production a missing or
+ * dev-fallback secret is a hard error (JWTs signed with a known secret are
+ * forgeable). In development the fallback is allowed but warned about loudly.
+ *
+ * Shares the DEV_FALLBACK_SECRETS set + message with the host adapter's
+ * assertProductionAuthSecret (see ../auth/auth-secret.ts) so both agree on what
+ * an insecure secret is.
+ */
+export declare function resolveAuthSecret(configSecret: string | undefined, opts?: {
+    isProduction?: boolean;
+    devFallback?: string;
+}): string;
+//# sourceMappingURL=env-guard.d.ts.map

package/dist/db/env-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-guard.d.ts","sourceRoot":"","sources":["../../src/db/env-guard.ts"],"names":[],"mappings":"AAWA,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAS3D;AAmBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4C1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAA;CAAE,CAiBxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,MAAM,CAkBR"}

package/dist/db/env-guard.js

@@ -0,0 +1,130 @@
+/**
+ * Friendly environment / connection guidance (F1a-J01-G2).
+ *
+ * A newcomer who forgets `createdb`, mistypes DATABASE_URL, or hasn't started
+ * Postgres should get one actionable line — not a raw `PostgresError: database
+ * "kywi_dev" does not exist` stack. These helpers translate the common failure
+ * modes into guidance and centralise the AUTH_SECRET fail-fast policy, so
+ * migrate / seed / seed:demo and the app entry point all speak the same way.
+ */
+import { isDevFallbackSecret, insecureAuthSecretMessage } from '../auth/auth-secret.js';
+/** Redact credentials from a connection string before showing it to the user. */
+export function redactDbUrl(url) {
+    if (!url)
+        return '(unset)';
+    try {
+        const u = new URL(url);
+        if (u.password)
+            u.password = '***';
+        return u.toString();
+    }
+    catch {
+        return url.replace(/:\/\/([^:@/]+):[^@/]+@/, '://$1:***@');
+    }
+}
+/** Extract the database name from a connection string, if present. */
+function dbNameFromUrl(url) {
+    if (!url)
+        return null;
+    try {
+        const path = new URL(url).pathname.replace(/^\//, '');
+        return path || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Turn a database connection/query error into a friendly, actionable message,
+ * or return null when the error is not a recognised connection problem (so the
+ * caller can rethrow the original).
+ */
+export function explainDbError(err, dbUrl) {
+    const e = (err ?? {});
+    const code = e.code;
+    const shown = redactDbUrl(dbUrl);
+    const dbName = dbNameFromUrl(dbUrl);
+    // Postgres: database does not exist.
+    if (code === '3D000') {
+        const name = dbName ?? 'your_database';
+        return [
+            `Database "${name}" does not exist.`,
+            ``,
+            `  Create it, then re-run:`,
+            `    createdb ${name}`,
+            ``,
+            `  (DATABASE_URL = ${shown})`,
+        ].join('\n');
+    }
+    // Postgres: authentication failed.
+    if (code === '28P01' || code === '28000') {
+        return [
+            `Database authentication failed for ${shown}.`,
+            `  Check the username/password in DATABASE_URL.`,
+        ].join('\n');
+    }
+    // Connection refused — server not running / wrong host:port.
+    if (code === 'ECONNREFUSED') {
+        return [
+            `Could not connect to the database at ${shown}.`,
+            `  Is PostgreSQL running? Start it, or fix the host/port in DATABASE_URL.`,
+        ].join('\n');
+    }
+    // Host not found.
+    if (code === 'ENOTFOUND' || code === 'EAI_AGAIN') {
+        return [
+            `Database host not found for ${shown}.`,
+            `  Check the host in DATABASE_URL.`,
+        ].join('\n');
+    }
+    return null;
+}
+/**
+ * Resolve the effective database URL, or throw a friendly error when NOTHING
+ * provides one (no config.db.url and no DATABASE_URL). Returns the url plus
+ * where it came from so callers can warn on a silent fallback.
+ */
+export function resolveDatabaseUrl(configUrl, fallback) {
+    if (configUrl)
+        return { url: configUrl, source: 'config' };
+    const env = process.env['DATABASE_URL'];
+    if (env)
+        return { url: env, source: 'env' };
+    if (fallback)
+        return { url: fallback, source: 'fallback' };
+    const err = new Error([
+        `DATABASE_URL is not set.`,
+        ``,
+        `  Set it in your environment (or .env), e.g.:`,
+        `    export DATABASE_URL=postgres://localhost:5432/my_db`,
+        ``,
+        `  and create the database first with:  createdb my_db`,
+    ].join('\n'));
+    err.userFacing = true;
+    throw err;
+}
+/**
+ * Resolve the auth secret with a fail-fast policy: in production a missing or
+ * dev-fallback secret is a hard error (JWTs signed with a known secret are
+ * forgeable). In development the fallback is allowed but warned about loudly.
+ *
+ * Shares the DEV_FALLBACK_SECRETS set + message with the host adapter's
+ * assertProductionAuthSecret (see ../auth/auth-secret.ts) so both agree on what
+ * an insecure secret is.
+ */
+export function resolveAuthSecret(configSecret, opts) {
+    const isProduction = opts?.isProduction ?? process.env['NODE_ENV'] === 'production';
+    const secret = configSecret ?? process.env['AUTH_SECRET'];
+    if (!isDevFallbackSecret(secret))
+        return secret;
+    if (isProduction) {
+        const err = new Error(insecureAuthSecretMessage());
+        err.userFacing = true;
+        throw err;
+    }
+    const fallback = opts?.devFallback ?? 'dev-secret-change-in-production';
+    console.warn(`[kywi] AUTH_SECRET is not set — using an INSECURE development fallback. ` +
+        `Set AUTH_SECRET to a strong random value before deploying to production.`);
+    return secret ?? fallback;
+}
+//# sourceMappingURL=env-guard.js.map

package/dist/db/env-guard.js.map

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

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

@@ -0,0 +1,223 @@
+import type { ExtendAttributeType } from '../schema/extensions.js';
+import type { KywiDb, PartialUndefined } from './client.js';
+export declare function createSubtype(db: KywiDb, data: {
+    name: string;
+    baseContentType: string;
+    description?: string | undefined;
+    isActive?: boolean | undefined;
+}): Promise<{
+    id: string;
+    createdAt: Date;
+    name: string;
+    isActive: boolean;
+    description: string | null;
+    baseContentType: string;
+}>;
+export declare function updateSubtype(db: KywiDb, id: string, data: PartialUndefined<{
+    name: string;
+    baseContentType: string;
+    description: string | null;
+    isActive: boolean;
+}>): Promise<{
+    id: string;
+    name: string;
+    baseContentType: string;
+    description: string | null;
+    isActive: boolean;
+    createdAt: Date;
+} | null>;
+export declare function deleteSubtype(db: KywiDb, id: string): Promise<boolean>;
+export declare function listSubtypes(db: KywiDb): Promise<{
+    id: string;
+    createdAt: Date;
+    name: string;
+    isActive: boolean;
+    description: string | null;
+    baseContentType: string;
+}[]>;
+export declare function createAttributeSet(db: KywiDb, data: {
+    subtypeId: string;
+    name: string;
+    label: string;
+    sortOrder?: number | undefined;
+}): Promise<{
+    id: string;
+    sortOrder: number;
+    createdAt: Date;
+    name: string;
+    label: string;
+    subtypeId: string;
+}>;
+export declare function updateAttributeSet(db: KywiDb, id: string, data: PartialUndefined<{
+    name: string;
+    label: string;
+    sortOrder: number;
+}>): Promise<{
+    id: string;
+    subtypeId: string;
+    name: string;
+    label: string;
+    sortOrder: number;
+    createdAt: Date;
+} | null>;
+export declare function deleteAttributeSet(db: KywiDb, id: string): Promise<boolean>;
+export declare function listAttributeSets(db: KywiDb, subtypeId: string): Promise<{
+    id: string;
+    sortOrder: number;
+    createdAt: Date;
+    name: string;
+    label: string;
+    subtypeId: string;
+}[]>;
+export declare function createAttribute(db: KywiDb, data: {
+    setId: string;
+    name: string;
+    label: string;
+    type: ExtendAttributeType;
+    defaultValue?: string | undefined;
+    validation?: Record<string, unknown> | undefined;
+    sortOrder?: number | undefined;
+}): Promise<{
+    id: string;
+    sortOrder: number;
+    createdAt: Date;
+    validation: unknown;
+    type: string;
+    name: string;
+    label: string;
+    defaultValue: string | null;
+    setId: string;
+}>;
+export declare function updateAttribute(db: KywiDb, id: string, data: PartialUndefined<{
+    name: string;
+    label: string;
+    type: ExtendAttributeType;
+    defaultValue: string | null;
+    validation: Record<string, unknown> | null;
+    sortOrder: number;
+}>): Promise<{
+    id: string;
+    setId: string;
+    name: string;
+    label: string;
+    type: string;
+    defaultValue: string | null;
+    validation: unknown;
+    sortOrder: number;
+    createdAt: Date;
+} | null>;
+export declare function deleteAttribute(db: KywiDb, id: string): Promise<boolean>;
+export declare function listAttributes(db: KywiDb, setId: string): Promise<{
+    id: string;
+    sortOrder: number;
+    createdAt: Date;
+    validation: unknown;
+    type: string;
+    name: string;
+    label: string;
+    defaultValue: string | null;
+    setId: string;
+}[]>;
+/**
+ * Get all extension data for a content item, joined with attribute definitions.
+ * Returns rows with attribute name, label, type, and the stored value.
+ */
+export declare function getExtendedData(db: KywiDb, contentId: string): Promise<{
+    id: string;
+    contentId: string;
+    attributeId: string;
+    attributeName: string;
+    attributeLabel: string;
+    attributeType: string;
+    stringValue: string | null;
+    numberValue: string | null;
+    dateValue: Date | null;
+    booleanValue: boolean | null;
+    jsonValue: unknown;
+    createdAt: Date;
+    updatedAt: Date;
+}[]>;
+export interface ApplicableExtensionAttribute {
+    id: string;
+    name: string;
+    label: string;
+    type: string;
+    defaultValue: string | null;
+    value: unknown;
+}
+export interface ApplicableExtensionSet {
+    id: string;
+    name: string;
+    label: string;
+    sortOrder: number;
+    subtypeId: string;
+    subtypeName: string;
+    attributes: ApplicableExtensionAttribute[];
+}
+/**
+ * Assemble the attribute sets that apply to a content item — every active
+ * subtype whose `baseContentType` is one of `baseContentTypes` (a content
+ * item's own type name AND its baseType are both offered so either wiring
+ * matches), with each attribute's current value for `contentId` merged in.
+ * This is the single read the editor's extension-set group (Tab 1) consumes.
+ */
+export declare function getApplicableExtensionData(db: KywiDb, baseContentTypes: string[], contentId: string): Promise<{
+    sets: ApplicableExtensionSet[];
+}>;
+/**
+ * Upsert a single extension value. Determines the correct storage column
+ * based on the attribute type, then inserts or updates accordingly.
+ */
+export declare function setExtendedValue(db: KywiDb, contentId: string, attributeId: string, value: unknown): Promise<{
+    id: string;
+    updatedAt: Date;
+    createdAt: Date;
+    contentId: string;
+    stringValue: string | null;
+    numberValue: string | null;
+    dateValue: Date | null;
+    booleanValue: boolean | null;
+    jsonValue: unknown;
+    attributeId: string;
+}>;
+/**
+ * Delete all extension data for a content item.
+ */
+export declare function clearExtendedData(db: KywiDb, contentId: string): Promise<boolean>;
+export declare function getRelatedSetData(db: KywiDb, contentId: string, setId: string): Promise<{
+    id: string;
+    sortOrder: number;
+    createdAt: Date;
+    data: unknown;
+    contentId: string;
+    setId: string;
+}[]>;
+export declare function addRelatedSetRow(db: KywiDb, contentId: string, setId: string, data: Record<string, unknown>[]): Promise<{
+    id: string;
+    sortOrder: number;
+    createdAt: Date;
+    data: unknown;
+    contentId: string;
+    setId: string;
+}>;
+export declare function updateRelatedSetRow(db: KywiDb, id: string, data: Record<string, unknown>[]): Promise<{
+    id: string;
+    contentId: string;
+    setId: string;
+    data: unknown;
+    sortOrder: number;
+    createdAt: Date;
+} | null>;
+export declare function removeRelatedSetRow(db: KywiDb, id: string): Promise<boolean>;
+export declare function reorderRelatedSetRows(db: KywiDb, items: {
+    id: string;
+    sortOrder: number;
+}[]): Promise<{
+    id: string;
+    contentId: string;
+    setId: string;
+    data: unknown;
+    sortOrder: number;
+    createdAt: Date;
+}[]>;
+//# sourceMappingURL=extension-queries.d.ts.map

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

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