@angriff36/manifest 2.18.0

package/dist/manifest/projections/materialized-views/expression-to-sql.js

@@ -0,0 +1,211 @@
+/**
+ * IRExpression → PostgreSQL SQL translator.
+ *
+ * Used by the materialized-views projection to translate computed-property
+ * expressions from the IR into SELECT expressions suitable for
+ * `CREATE MATERIALIZED VIEW` bodies.
+ *
+ * Boundary: the translator emits literal SQL fragments. It does NOT validate
+ * that the resulting SQL is well-formed; it trusts the IR expression tree
+ * and the `views[].columns` overrides supplied by the consumer.
+ *
+ * Unsupported expression kinds produce a diagnostic. The generator collects
+ * diagnostics and emits error-level entries for unsupported forms.
+ */
+/**
+ * Translate an IRExpression to a PostgreSQL SELECT expression.
+ *
+ * The `entityName` is used only for diagnostic context. The `columnResolver`
+ * maps a property name (e.g. "amount") to its SQL column name (e.g. "amount")
+ * — this lets the generator apply consumer-supplied column mappings.
+ */
+export function translateExpression(expr, columnResolver, entityName) {
+    const diagnostics = [];
+    const sql = translateNode(expr, columnResolver, entityName, diagnostics);
+    return { sql, diagnostics };
+}
+function translateNode(expr, columnResolver, entityName, diagnostics) {
+    switch (expr.kind) {
+        case 'literal':
+            return translateLiteral(expr.value);
+        case 'identifier': {
+            const resolved = columnResolver(expr.name);
+            if (resolved === undefined) {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'UNKNOWN_PROPERTY',
+                    message: `Unknown property '${expr.name}' referenced in expression for entity '${entityName}'.`,
+                    entity: entityName,
+                });
+                return `"${expr.name}"`;
+            }
+            return resolved;
+        }
+        case 'member': {
+            // member access: translate the object, then access a property.
+            // e.g. event.payload.amount → "payload"."amount"
+            const obj = translateNode(expr.object, columnResolver, entityName, diagnostics);
+            return `${obj}."${expr.property}"`;
+        }
+        case 'binary': {
+            const left = translateNode(expr.left, columnResolver, entityName, diagnostics);
+            const right = translateNode(expr.right, columnResolver, entityName, diagnostics);
+            const op = translateBinaryOperator(expr.operator);
+            if (op === null) {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'UNSUPPORTED_BINARY_OP',
+                    message: `Unsupported binary operator '${expr.operator}' in expression for entity '${entityName}'.`,
+                    entity: entityName,
+                });
+                return `(${left} ${expr.operator} ${right})`;
+            }
+            return `(${left} ${op} ${right})`;
+        }
+        case 'unary': {
+            const operand = translateNode(expr.operand, columnResolver, entityName, diagnostics);
+            const op = translateUnaryOperator(expr.operator);
+            if (op === null) {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'UNSUPPORTED_UNARY_OP',
+                    message: `Unsupported unary operator '${expr.operator}' in expression for entity '${entityName}'.`,
+                    entity: entityName,
+                });
+                return `${expr.operator} ${operand}`;
+            }
+            return `${op} ${operand}`;
+        }
+        case 'call': {
+            const callee = expr.callee;
+            if (callee.kind !== 'identifier') {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'UNSUPPORTED_CALL',
+                    message: `Unsupported call expression in materialized view for entity '${entityName}'. Only direct identifier calls (e.g. SUM, COUNT) are supported.`,
+                    entity: entityName,
+                });
+                return 'NULL';
+            }
+            const args = expr.args
+                .map((a) => translateNode(a, columnResolver, entityName, diagnostics))
+                .join(', ');
+            return `${callee.name}(${args})`;
+        }
+        case 'conditional': {
+            const cond = translateNode(expr.condition, columnResolver, entityName, diagnostics);
+            const cons = translateNode(expr.consequent, columnResolver, entityName, diagnostics);
+            const alt = translateNode(expr.alternate, columnResolver, entityName, diagnostics);
+            return `CASE WHEN ${cond} THEN ${cons} ELSE ${alt} END`;
+        }
+        case 'array': {
+            const elements = expr.elements
+                .map((e) => translateNode(e, columnResolver, entityName, diagnostics))
+                .join(', ');
+            return `ARRAY[${elements}]`;
+        }
+        case 'object': {
+            diagnostics.push({
+                severity: 'warning',
+                code: 'OBJECT_EXPRESSION_INLINED',
+                message: `Object expression in materialized view for entity '${entityName}' cannot be represented in a relational view. Emitted as JSON string.`,
+                entity: entityName,
+            });
+            const props = expr.properties
+                .map((p) => `"${p.key}", ${translateNode(p.value, columnResolver, entityName, diagnostics)}`)
+                .join(', ');
+            return `json_build_object(${props})`;
+        }
+        case 'lambda': {
+            diagnostics.push({
+                severity: 'error',
+                code: 'UNSUPPORTED_LAMBDA',
+                message: `Lambda expressions are not supported in materialized views for entity '${entityName}'.`,
+                entity: entityName,
+            });
+            return 'NULL';
+        }
+        case 'aggregate': {
+            // A cross-entity count is a correlated subquery, not a plain SELECT
+            // expression; the materialized-view projection does not resolve child
+            // columns, so this is emitted as a loud (non-silent) NULL.
+            diagnostics.push({
+                severity: 'error',
+                code: 'UNSUPPORTED_AGGREGATE',
+                message: `Aggregate count over '${expr.entity}' is not supported in materialized views for entity '${entityName}' (cross-entity subquery).`,
+                entity: entityName,
+            });
+            return 'NULL';
+        }
+    }
+}
+function translateLiteral(value) {
+    switch (value.kind) {
+        case 'string':
+            // PostgreSQL: double single-quotes for embedded single quotes.
+            return `'${value.value.replace(/'/g, "''")}'`;
+        case 'number':
+            return String(value.value);
+        case 'boolean':
+            return value.value ? 'TRUE' : 'FALSE';
+        case 'null':
+            return 'NULL';
+        case 'array': {
+            const elements = value.elements.map(translateLiteral).join(', ');
+            return `ARRAY[${elements}]`;
+        }
+        case 'object': {
+            const pairs = Object.entries(value.properties)
+                .map(([k, v]) => `'${k}', ${translateLiteral(v)}`)
+                .join(', ');
+            return `json_build_object(${pairs})`;
+        }
+    }
+}
+/**
+ * Map a Manifest binary operator to its PostgreSQL counterpart.
+ * Returns null for unsupported operators.
+ */
+function translateBinaryOperator(op) {
+    switch (op) {
+        case '+':
+        case '-':
+        case '*':
+        case '/':
+        case '%':
+        case '==':
+        case '!=':
+        case '<':
+        case '<=':
+        case '>':
+        case '>=':
+        case '&&':
+        case '||':
+            return op;
+        case '===':
+            return '=';
+        case '!==':
+            return '!=';
+        case 'and':
+        case 'AND':
+            return 'AND';
+        case 'or':
+        case 'OR':
+            return 'OR';
+        default:
+            return null;
+    }
+}
+function translateUnaryOperator(op) {
+    switch (op) {
+        case '!':
+        case 'not':
+        case 'NOT':
+            return 'NOT';
+        case '-':
+            return '-';
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=expression-to-sql.js.map

package/dist/manifest/projections/materialized-views/expression-to-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-to-sql.js","sourceRoot":"","sources":["../../../../src/manifest/projections/materialized-views/expression-to-sql.ts"],"names":[],"mappings":"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"}

package/dist/manifest/projections/materialized-views/generator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Materialized views projection.
+ *
+ * Consumes Manifest IR (entities + read models) + projection config and emits
+ * PostgreSQL `CREATE MATERIALIZED VIEW` DDL as one or more `ProjectionArtifact`s.
+ *
+ * The projection supports three refresh strategies:
+ *   - 'on-demand'         → emits REFRESH MATERIALIZED VIEW statements for manual calls
+ *   - 'scheduled'         → emits a pg_cron job that calls REFRESH on a schedule
+ *   - 'trigger-based'     → emits a trigger function that calls REFRESH on row changes
+ *
+ * Boundary rules (following Prisma/Drizzle/Kysely projection conventions):
+ *   - Relational interpretation starts HERE. No relational concept (view name,
+ *     column name, refresh strategy, index definitions) lives in Manifest core
+ *     grammar or IR — all of it arrives via projection options.
+ *   - The projection carries NO knowledge of any specific application,
+ *     database instance, tenant layout, or domain meaning of any field.
+ *   - `external: true` entities are skipped.
+ *   - Unknown expression kinds produce error diagnostics. No silent fallback.
+ */
+import type { IR } from '../../ir';
+import type { ProjectionRequest, ProjectionResult, ProjectionTarget } from '../interface';
+export declare class MaterializedViewsProjection implements ProjectionTarget {
+    readonly name = "materialized-views";
+    readonly description: string;
+    readonly surfaces: readonly ["materialized-views.ddl"];
+    generate(ir: IR, request: ProjectionRequest): ProjectionResult;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/manifest/projections/materialized-views/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/materialized-views/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAY,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAGV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAiOtB,qBAAa,2BAA4B,YAAW,gBAAgB;IAClE,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,WAAW,SAG0C;IAC9D,QAAQ,CAAC,QAAQ,sCAAY;IAE7B,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;CAgC/D"}

package/dist/manifest/projections/materialized-views/generator.js

@@ -0,0 +1,263 @@
+/**
+ * Materialized views projection.
+ *
+ * Consumes Manifest IR (entities + read models) + projection config and emits
+ * PostgreSQL `CREATE MATERIALIZED VIEW` DDL as one or more `ProjectionArtifact`s.
+ *
+ * The projection supports three refresh strategies:
+ *   - 'on-demand'         → emits REFRESH MATERIALIZED VIEW statements for manual calls
+ *   - 'scheduled'         → emits a pg_cron job that calls REFRESH on a schedule
+ *   - 'trigger-based'     → emits a trigger function that calls REFRESH on row changes
+ *
+ * Boundary rules (following Prisma/Drizzle/Kysely projection conventions):
+ *   - Relational interpretation starts HERE. No relational concept (view name,
+ *     column name, refresh strategy, index definitions) lives in Manifest core
+ *     grammar or IR — all of it arrives via projection options.
+ *   - The projection carries NO knowledge of any specific application,
+ *     database instance, tenant layout, or domain meaning of any field.
+ *   - `external: true` entities are skipped.
+ *   - Unknown expression kinds produce error diagnostics. No silent fallback.
+ */
+import { normalizeOptions } from './options.js';
+// ============================================================================
+// Surface identifiers
+// ============================================================================
+const SURFACE_DDL = 'materialized-views.ddl';
+const SURFACES = [SURFACE_DDL];
+// ============================================================================
+// SQL fragment builders
+// ============================================================================
+/** Default table naming strategy: PascalCase → snake_case plural. */
+function defaultTableName(entityName) {
+    const snake = entityName
+        .replace(/([A-Z])/g, (m, _ch, idx) => (idx === 0 ? m.toLowerCase() : '_' + m.toLowerCase()))
+        .replace(/[^a-z0-9_]/g, '');
+    return `${snake}s`;
+}
+/** Default view name: mv_ + snake_case. */
+function defaultViewName(defName) {
+    const snake = defName
+        .replace(/([A-Z])/g, (m, _ch, idx) => (idx === 0 ? m.toLowerCase() : '_' + m.toLowerCase()))
+        .replace(/[^a-z0-9_]/g, '');
+    return `mv_${snake}`;
+}
+/** Build a fully-qualified object name. */
+function qualify(name, schema) {
+    if (schema)
+        return `"${schema}"."${name}"`;
+    return `"${name}"`;
+}
+function resolveSource(ir, def, diagnostics) {
+    // For this projection, source resolution is: entity name match.
+    // Read models would be added here when ir exposes a top-level readModels array.
+    const entity = ir.entities.find((e) => e.name === def.source);
+    if (!entity) {
+        diagnostics.push({
+            severity: 'error',
+            code: 'UNKNOWN_SOURCE',
+            message: `Materialized view '${def.name}' references unknown source '${def.source}'. Must be an entity name.`,
+        });
+        return null;
+    }
+    const sourceTable = def.sourceTable ?? defaultTableName(def.source);
+    return { entity, sourceTable };
+}
+function emitMaterializedView(def, source, options) {
+    const diagnostics = [];
+    const viewName = def.viewName ?? def.name ?? defaultViewName(def.name);
+    const qualifiedViewName = qualify(viewName, options.schema);
+    // Build the SELECT body.
+    const selectLines = buildSelectClause(def, source, diagnostics);
+    const body = `${selectLines}\nFROM ${qualify(source.sourceTable, options.schema)}`;
+    // Build CREATE MATERIALIZED VIEW.
+    const strategy = def.refreshStrategy ?? 'on-demand';
+    const withNoData = def.withNoData ? ' WITH NO DATA' : ' WITH DATA';
+    const ddlLines = [];
+    ddlLines.push(`-- Materialized view: ${def.name} (refresh: ${strategy})`);
+    ddlLines.push(`CREATE MATERIALIZED VIEW ${qualifiedViewName}${withNoData}`);
+    ddlLines.push(`AS`);
+    ddlLines.push(body);
+    ddlLines.push(';');
+    ddlLines.push('');
+    // Append trailing SQL (GRANTs, etc.) if provided.
+    if (def.trailingSql) {
+        ddlLines.push(def.trailingSql.trim());
+        ddlLines.push('');
+    }
+    // Build indexes.
+    const indexStatements = (def.indexes ?? []).map((idx) => emitIndex(viewName, idx, options.schema));
+    // Build refresh strategy statements.
+    const refreshStatements = [];
+    if (options.emitRefreshStatements) {
+        if (strategy === 'on-demand') {
+            refreshStatements.push(`-- Refresh ${qualifiedViewName} manually:`);
+            refreshStatements.push(`REFRESH MATERIALIZED VIEW ${qualifiedViewName};`);
+        }
+        else if (strategy === 'scheduled') {
+            const schedule = def.schedule;
+            if (!schedule || (!schedule.cron && !schedule.interval)) {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'MISSING_SCHEDULE',
+                    message: `Materialized view '${def.name}' uses 'scheduled' strategy but has no schedule.cron or schedule.interval.`,
+                });
+            }
+            else {
+                const cronExpr = schedule.cron ?? schedule.interval;
+                refreshStatements.push(`-- Scheduled refresh for ${qualifiedViewName} via pg_cron:`);
+                refreshStatements.push(`SELECT cron.schedule('refresh_${viewName}', '${cronExpr}', ` +
+                    `'REFRESH MATERIALIZED VIEW ${qualifiedViewName}');`);
+            }
+        }
+        else if (strategy === 'trigger-based') {
+            const trigger = def.trigger;
+            if (!trigger || !trigger.sourceTable) {
+                diagnostics.push({
+                    severity: 'error',
+                    code: 'MISSING_TRIGGER',
+                    message: `Materialized view '${def.name}' uses 'trigger-based' strategy but has no trigger.sourceTable.`,
+                });
+            }
+            else {
+                const debounce = trigger.debounceSeconds ?? 0;
+                refreshStatements.push(`-- Trigger-based refresh for ${qualifiedViewName}`, `CREATE OR REPLACE FUNCTION refresh_${viewName}() RETURNS TRIGGER AS $$`, `BEGIN`, debounce > 0
+                    ? `  -- Debounce: callers may want to add a cooldown guard.`
+                    : `  -- No debounce configured.`, `  REFRESH MATERIALIZED VIEW ${qualifiedViewName};`, `  RETURN NULL;`, `END;`, `$$ LANGUAGE plpgsql;`, ``, `CREATE TRIGGER ${trigger.sourceTable}_refresh_${viewName}`, `  ${trigger.column ? `AFTER UPDATE OF "${trigger.column}"` : 'AFTER INSERT OR UPDATE OR DELETE'} ` +
+                    `ON ${qualify(trigger.sourceTable, options.schema)}`, `  FOR EACH STATEMENT EXECUTE FUNCTION refresh_${viewName}();`);
+            }
+        }
+    }
+    return {
+        viewName,
+        qualifiedViewName,
+        body: ddlLines.join('\n'),
+        indexes: indexStatements,
+        refresh: refreshStatements,
+        diagnostics,
+    };
+}
+function buildSelectClause(def, source, _diagnostics) {
+    // If the consumer supplied column expressions, use them verbatim.
+    if (def.columns && Object.keys(def.columns).length > 0) {
+        const lines = [];
+        lines.push('SELECT');
+        const entries = Object.entries(def.columns);
+        entries.forEach(([outputName, rawExpr], idx) => {
+            // rawExpr is a raw SQL fragment supplied by the consumer; we pass it through.
+            // The expression-to-sql translator in expression-to-sql.ts handles
+            // IRExpression tree translation; column overrides here are raw SQL.
+            const suffix = idx === entries.length - 1 ? '' : ',';
+            lines.push(`  ${rawExpr} AS "${outputName}"${suffix}`);
+        });
+        return lines.join('\n');
+    }
+    // Otherwise, emit SELECT with all stored properties of the entity.
+    const cols = source.entity.properties.map((p) => `"${p.name}"`).join(', ');
+    return `SELECT\n  ${cols || '*'}`;
+}
+function emitIndex(viewName, idx, schema) {
+    const method = idx.method ?? 'btree';
+    const unique = idx.unique ? 'UNIQUE ' : '';
+    const cols = idx.columns.map((c) => `"${c}"`).join(', ');
+    const indexName = idx.name ?? `idx_${viewName}_${idx.columns.join('_')}`;
+    const qualified = qualify(indexName, schema);
+    const on = qualify(viewName, schema);
+    const where = idx.where ? ` WHERE ${idx.where}` : '';
+    return `CREATE ${unique}INDEX ${qualified} ON ${on} USING ${method} (${cols})${where};`;
+}
+// ============================================================================
+// ProjectionTarget implementation
+// ============================================================================
+export class MaterializedViewsProjection {
+    name = 'materialized-views';
+    description = 'Generates PostgreSQL CREATE MATERIALIZED VIEW DDL from IR entities and read models ' +
+        'with @materialized computed properties. Supports on-demand, scheduled (pg_cron), and ' +
+        'trigger-based refresh strategies plus supporting indexes.';
+    surfaces = SURFACES;
+    generate(ir, request) {
+        const allDiagnostics = [];
+        if (!SURFACES.includes(request.surface)) {
+            allDiagnostics.push({
+                severity: 'error',
+                code: 'UNKNOWN_SURFACE',
+                message: `Materialized-views projection does not support surface '${request.surface}'. Supported: ${SURFACES.join(', ')}.`,
+            });
+            return { artifacts: [], diagnostics: allDiagnostics };
+        }
+        const options = normalizeOptions(request.options);
+        if (!options.views || options.views.length === 0) {
+            allDiagnostics.push({
+                severity: 'warning',
+                code: 'NO_VIEWS_DECLARED',
+                message: 'No materialized views declared in projection options. Pass `views` to generate DDL.',
+            });
+            return { artifacts: [], diagnostics: allDiagnostics };
+        }
+        if (options.emitSingleFile) {
+            const artifact = emitSingleFile(ir, options, allDiagnostics);
+            return { artifacts: artifact ? [artifact] : [], diagnostics: allDiagnostics };
+        }
+        const artifacts = options.views.map((view) => emitPerViewArtifact(ir, view, options, allDiagnostics));
+        return { artifacts, diagnostics: allDiagnostics };
+    }
+}
+function emitSingleFile(ir, options, diagnostics) {
+    const lines = [];
+    lines.push('-- ============================================================');
+    lines.push('-- Materialized views DDL generated from Manifest IR');
+    lines.push('-- ============================================================');
+    lines.push('--');
+    lines.push(`-- Views: ${options.views.length}`);
+    lines.push(`-- Schema: ${options.schema ?? '(default search_path)'}`);
+    lines.push('');
+    for (const def of options.views) {
+        const source = resolveSource(ir, def, diagnostics);
+        if (!source)
+            continue;
+        const emission = emitMaterializedView(def, source, options);
+        diagnostics.push(...emission.diagnostics);
+        lines.push(`-- ---------- View: ${def.name} ----------`);
+        lines.push(emission.body);
+        if (emission.indexes.length > 0) {
+            lines.push(`-- Indexes for ${emission.viewName}:`);
+            for (const idx of emission.indexes)
+                lines.push(idx);
+            lines.push('');
+        }
+        if (emission.refresh.length > 0) {
+            lines.push(`-- Refresh strategy for ${emission.viewName}:`);
+            for (const r of emission.refresh)
+                lines.push(r);
+            lines.push('');
+        }
+    }
+    return {
+        id: 'materialized-views.ddl',
+        pathHint: options.output,
+        contentType: 'sql',
+        code: lines.join('\n'),
+    };
+}
+function emitPerViewArtifact(ir, def, options, diagnostics) {
+    const lines = [];
+    const source = resolveSource(ir, def, diagnostics);
+    if (source) {
+        const emission = emitMaterializedView(def, source, options);
+        diagnostics.push(...emission.diagnostics);
+        lines.push(emission.body);
+        for (const idx of emission.indexes)
+            lines.push(idx);
+        for (const r of emission.refresh)
+            lines.push(r);
+    }
+    else {
+        lines.push(`-- ERROR: source '${def.source}' could not be resolved for view '${def.name}'.`);
+    }
+    return {
+        id: `materialized-views.${def.name}.ddl`,
+        pathHint: `${def.name}.sql`,
+        contentType: 'sql',
+        code: lines.join('\n'),
+    };
+}
+//# sourceMappingURL=generator.js.map

package/dist/manifest/projections/materialized-views/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../src/manifest/projections/materialized-views/generator.ts"],"names":[],"mappings":"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"}

package/dist/manifest/projections/materialized-views/options.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Configuration surface for the materialized-views projection.
+ *
+ * Every relational concept (view name, column name, refresh strategy, index
+ * definitions) is supplied here at projection time. NONE of these enter
+ * Manifest core grammar or IR. The projection translates IR + this options
+ * bag into PostgreSQL `CREATE MATERIALIZED VIEW` DDL.
+ *
+ * The projection consumes `IRReadModel[]` (denormalized views maintained by
+ * the runtime) and `IREntity[]` (entities with computed properties that the
+ * caller has marked as materialized via the `views` option).
+ */
+import type { MaterializedViewDefinition } from './types.js';
+export interface MaterializedViewsProjectionOptions {
+    /**
+     * Materialized view definitions to generate. Each entry maps an IR
+     * read model or entity to a PostgreSQL materialized view.
+     *
+     *   views: [{
+     *     name: "daily_order_totals",
+     *     source: "Order",
+     *     refreshStrategy: "scheduled",
+     *     schedule: { cron: "0 * * * *" },
+     *     columns: { day: "DATE_TRUNC('day', created_at)", total: "SUM(amount)" },
+     *     indexes: [{ columns: ["day"], unique: true }]
+     *   }]
+     */
+    views?: MaterializedViewDefinition[];
+    /**
+     * Whether to emit a single artifact with all views, or one artifact
+     * per view. Default: true (single file).
+     */
+    emitSingleFile?: boolean;
+    /**
+     * Output path hint for the emitted artifact. The projection itself
+     * does not write files. Default: "materialized-views.sql".
+     */
+    output?: string;
+    /**
+     * Schema to qualify view and index names with (e.g. "analytics").
+     * If omitted, objects are unqualified (live in the search_path default).
+     */
+    schema?: string;
+    /**
+     * Whether to emit REFRESH MATERIALIZED VIEW statements as part of
+     * the artifact (for on-demand strategy) or as a separate function
+     * that can be called manually. Default: true (inline statements).
+     */
+    emitRefreshStatements?: boolean;
+}
+/**
+ * Defaults. Kept as an exported const so consumers and tests can introspect.
+ */
+export declare const MATERIALIZED_VIEWS_PROJECTION_DEFAULTS: Required<Pick<MaterializedViewsProjectionOptions, 'emitSingleFile' | 'output' | 'emitRefreshStatements'>>;
+/**
+ * Normalize a raw `request.options` bag into a fully-typed options object.
+ */
+export declare function normalizeOptions(raw: Record<string, unknown> | undefined): MaterializedViewsProjectionOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/manifest/projections/materialized-views/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/materialized-views/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,kCAAkC;IACjD;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAErC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,sCAAsC,EAAE,QAAQ,CAC3D,IAAI,CAAC,kCAAkC,EAAE,gBAAgB,GAAG,QAAQ,GAAG,uBAAuB,CAAC,CAKvF,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACvC,kCAAkC,CAUpC"}

package/dist/manifest/projections/materialized-views/options.js

@@ -0,0 +1,34 @@
+/**
+ * Configuration surface for the materialized-views projection.
+ *
+ * Every relational concept (view name, column name, refresh strategy, index
+ * definitions) is supplied here at projection time. NONE of these enter
+ * Manifest core grammar or IR. The projection translates IR + this options
+ * bag into PostgreSQL `CREATE MATERIALIZED VIEW` DDL.
+ *
+ * The projection consumes `IRReadModel[]` (denormalized views maintained by
+ * the runtime) and `IREntity[]` (entities with computed properties that the
+ * caller has marked as materialized via the `views` option).
+ */
+/**
+ * Defaults. Kept as an exported const so consumers and tests can introspect.
+ */
+export const MATERIALIZED_VIEWS_PROJECTION_DEFAULTS = {
+    emitSingleFile: true,
+    output: 'materialized-views.sql',
+    emitRefreshStatements: true,
+};
+/**
+ * Normalize a raw `request.options` bag into a fully-typed options object.
+ */
+export function normalizeOptions(raw) {
+    const input = (raw ?? {});
+    return {
+        views: input.views ?? [],
+        emitSingleFile: input.emitSingleFile ?? MATERIALIZED_VIEWS_PROJECTION_DEFAULTS.emitSingleFile,
+        output: input.output ?? MATERIALIZED_VIEWS_PROJECTION_DEFAULTS.output,
+        schema: input.schema,
+        emitRefreshStatements: input.emitRefreshStatements ?? MATERIALIZED_VIEWS_PROJECTION_DEFAULTS.emitRefreshStatements,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/manifest/projections/materialized-views/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/manifest/projections/materialized-views/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA8CH;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAE/C;IACF,cAAc,EAAE,IAAI;IACpB,MAAM,EAAE,wBAAwB;IAChC,qBAAqB,EAAE,IAAI;CACnB,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAwC;IAExC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,CAAgD,CAAC;IACzE,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,sCAAsC,CAAC,cAAc;QAC7F,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,sCAAsC,CAAC,MAAM;QACrE,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,qBAAqB,EACnB,KAAK,CAAC,qBAAqB,IAAI,sCAAsC,CAAC,qBAAqB;KAC9F,CAAC;AACJ,CAAC"}