@angriff36/manifest 2.18.0

package/dist/manifest/projections/elasticsearch/options.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Configuration surface for the Elasticsearch projection.
+ *
+ * Every search-specific concept (index definitions, field overrides, analyzer
+ * configurations, ingest pipeline settings) is supplied here. NONE of these
+ * enter Manifest core grammar or IR.
+ *
+ * The projection discovers searchable entities from `ir.stores` entries with
+ * `target === 'elasticsearch'` AND from `ir.readModels` (which are denormalized
+ * views that map naturally to search indexes).
+ *
+ * Options also accept a `searchable` boolean on entity store configs to opt
+ * specific entities into indexing (e.g. `store Order in elasticsearch searchable: true`).
+ */
+import type { ElasticsearchIndexDefinition, ESIngestPipeline, ESIndexerConfig } from './types.js';
+export interface ElasticsearchProjectionOptions {
+    /**
+     * Explicit index definitions. When omitted, the projection auto-derives
+     * one index per entity declared with `store X in elasticsearch`.
+     */
+    indices?: ElasticsearchIndexDefinition[];
+    /**
+     * Ingest pipelines to emit alongside the index mappings.
+     * Each pipeline can be referenced by index definitions.
+     */
+    ingestPipelines?: ESIngestPipeline[];
+    /**
+     * Configuration for the generated outbox-driven indexer worker.
+     * Controls batch size, retry logic, and refresh policy.
+     */
+    indexerConfig?: ESIndexerConfig;
+    /**
+     * Whether to emit a single combined mapping file or one per index.
+     * Default: true (single file).
+     */
+    emitSingleFile?: boolean;
+    /**
+     * Output path hint for the mapping artifact.
+     * Default: "elasticsearch-mappings.json"
+     */
+    output?: string;
+    /**
+     * Global index name prefix applied to all generated indices.
+     * E.g. "prod_" produces "prod_orders".
+     */
+    indexNamePrefix?: string;
+}
+/**
+ * Defaults for the Elasticsearch projection.
+ */
+export declare const ELASTICSEARCH_PROJECTION_DEFAULTS: Required<Pick<ElasticsearchProjectionOptions, 'emitSingleFile' | 'output' | 'indexNamePrefix'>>;
+/**
+ * Normalize raw options into a fully-typed configuration object.
+ */
+export declare function normalizeOptions(raw: Record<string, unknown> | undefined): ElasticsearchProjectionOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/manifest/projections/elasticsearch/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/elasticsearch/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAC5B,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,OAAO,CAAC,EAAE,4BAA4B,EAAE,CAAC;IAEzC;;;OAGG;IACH,eAAe,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,eAAe,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CACtD,IAAI,CACF,8BAA8B,EAC9B,gBAAgB,GAAG,QAAQ,GAAG,iBAAiB,CAChD,CAKO,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACvC,8BAA8B,CAUhC"}

package/dist/manifest/projections/elasticsearch/options.js

@@ -0,0 +1,37 @@
+/**
+ * Configuration surface for the Elasticsearch projection.
+ *
+ * Every search-specific concept (index definitions, field overrides, analyzer
+ * configurations, ingest pipeline settings) is supplied here. NONE of these
+ * enter Manifest core grammar or IR.
+ *
+ * The projection discovers searchable entities from `ir.stores` entries with
+ * `target === 'elasticsearch'` AND from `ir.readModels` (which are denormalized
+ * views that map naturally to search indexes).
+ *
+ * Options also accept a `searchable` boolean on entity store configs to opt
+ * specific entities into indexing (e.g. `store Order in elasticsearch searchable: true`).
+ */
+/**
+ * Defaults for the Elasticsearch projection.
+ */
+export const ELASTICSEARCH_PROJECTION_DEFAULTS = {
+    emitSingleFile: true,
+    output: 'elasticsearch-mappings.json',
+    indexNamePrefix: '',
+};
+/**
+ * Normalize raw options into a fully-typed configuration object.
+ */
+export function normalizeOptions(raw) {
+    const input = (raw ?? {});
+    return {
+        indices: input.indices,
+        ingestPipelines: input.ingestPipelines,
+        indexerConfig: input.indexerConfig,
+        emitSingleFile: input.emitSingleFile ?? ELASTICSEARCH_PROJECTION_DEFAULTS.emitSingleFile,
+        output: input.output ?? ELASTICSEARCH_PROJECTION_DEFAULTS.output,
+        indexNamePrefix: input.indexNamePrefix ?? ELASTICSEARCH_PROJECTION_DEFAULTS.indexNamePrefix,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/manifest/projections/elasticsearch/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/manifest/projections/elasticsearch/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA8CH;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAK1C;IACF,cAAc,EAAE,IAAI;IACpB,MAAM,EAAE,6BAA6B;IACrC,eAAe,EAAE,EAAE;CACX,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAwC;IAExC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,CAA4C,CAAC;IACrE,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,iCAAiC,CAAC,cAAc;QACxF,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,iCAAiC,CAAC,MAAM;QAChE,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,iCAAiC,CAAC,eAAe;KAC5F,CAAC;AACJ,CAAC"}

package/dist/manifest/projections/elasticsearch/type-mapping.d.ts

@@ -0,0 +1,30 @@
+/**
+ * IR type → Elasticsearch field type mapping table.
+ *
+ * Mirrors the Drizzle projection's `DEFAULT_TYPE_MAPPING` pattern:
+ * a frozen record of IR type names to ES field type definitions.
+ *
+ * CRITICAL: 'number' is INTENTIONALLY ABSENT — it is ambiguous in Manifest
+ * (could be int, float, or decimal). Mapping it silently would produce
+ * incorrect ES types. The generator emits a hard `ELASTICSEARCH_AMBIGUOUS_NUMBER`
+ * diagnostic instead. No silent fallback, ever.
+ *
+ * Additional unsupported types (e.g. 'bytes', 'uuid' as text) produce
+ * `ELASTICSEARCH_UNSUPPORTED_TYPE` diagnostics.
+ */
+export interface ESFieldType {
+    /** Elasticsearch field type (keyword, text, integer, long, etc.) */
+    type: string;
+    /** Whether doc_values are enabled (default: true for keyword/numeric) */
+    doc_values?: boolean;
+    /** Optional index setting (e.g. false for large text fields) */
+    index?: boolean;
+    /** Scaling factor for scaled_float */
+    scaling_factor?: number;
+    /** Optional analyzer hint (standard, simple, whitespace) */
+    analyzer?: string;
+}
+export declare const ES_TYPE_MAPPING: Readonly<Record<string, ESFieldType>>;
+/** Types that the generator will refuse to map (produces diagnostic). */
+export declare const UNSUPPORTED_ES_TYPES: ReadonlySet<string>;
+//# sourceMappingURL=type-mapping.d.ts.map

package/dist/manifest/projections/elasticsearch/type-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-mapping.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/elasticsearch/type-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAahE,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAGnD,CAAC"}

package/dist/manifest/projections/elasticsearch/type-mapping.js

@@ -0,0 +1,34 @@
+/**
+ * IR type → Elasticsearch field type mapping table.
+ *
+ * Mirrors the Drizzle projection's `DEFAULT_TYPE_MAPPING` pattern:
+ * a frozen record of IR type names to ES field type definitions.
+ *
+ * CRITICAL: 'number' is INTENTIONALLY ABSENT — it is ambiguous in Manifest
+ * (could be int, float, or decimal). Mapping it silently would produce
+ * incorrect ES types. The generator emits a hard `ELASTICSEARCH_AMBIGUOUS_NUMBER`
+ * diagnostic instead. No silent fallback, ever.
+ *
+ * Additional unsupported types (e.g. 'bytes', 'uuid' as text) produce
+ * `ELASTICSEARCH_UNSUPPORTED_TYPE` diagnostics.
+ */
+export const ES_TYPE_MAPPING = Object.freeze({
+    string: { type: 'keyword' },
+    text: { type: 'text' },
+    uuid: { type: 'keyword' },
+    int: { type: 'integer' },
+    bigint: { type: 'long' },
+    float: { type: 'float' },
+    decimal: { type: 'scaled_float', scaling_factor: 100 },
+    boolean: { type: 'boolean' },
+    date: { type: 'date' },
+    datetime: { type: 'date' },
+    json: { type: 'object', doc_values: false, index: false },
+    // 'number' is deliberately absent — see file header.
+});
+/** Types that the generator will refuse to map (produces diagnostic). */
+export const UNSUPPORTED_ES_TYPES = new Set([
+    'number', // ambiguous — see file header
+    'bytes', // binary — not representable as a search field
+]);
+//# sourceMappingURL=type-mapping.js.map

package/dist/manifest/projections/elasticsearch/type-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-mapping.js","sourceRoot":"","sources":["../../../../src/manifest/projections/elasticsearch/type-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,MAAM,CAAC,MAAM,eAAe,GAA0C,MAAM,CAAC,MAAM,CAAC;IAClF,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACtB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IACzB,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IACxB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACxB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;IACxB,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,EAAE;IACtD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IACtB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;IAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;IACzD,qDAAqD;CACtD,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IAC/D,QAAQ,EAAE,8BAA8B;IACxC,OAAO,EAAG,+CAA+C;CAC1D,CAAC,CAAC"}

package/dist/manifest/projections/elasticsearch/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Type definitions for the Elasticsearch projection.
+ *
+ * All search-specific concepts (index settings, analyzer configurations,
+ * field overrides, pipeline definitions) are declared here. None of these
+ * enter Manifest core grammar or IR — they arrive via projection options
+ * or are inferred deterministically from IR.
+ */
+/** A single field mapping override for a specific property. */
+export interface ESFieldOverride {
+    /** Elasticsearch field type to use (e.g. "text", "keyword", "date") */
+    type: string;
+    /** Optional analyzer for text fields */
+    analyzer?: string;
+    /** Whether the field is searchable */
+    index?: boolean;
+    /** Whether doc_values are stored */
+    doc_values?: boolean;
+    /** Custom field name in the index (defaults to property name) */
+    fieldName?: string;
+}
+/** Configuration for a single Elasticsearch index derived from an entity. */
+export interface ElasticsearchIndexDefinition {
+    /** Entity name to index (must match an IREntity.name) */
+    entity: string;
+    /** Override the index name (defaults to lowercase entity name) */
+    indexName?: string;
+    /** Number of shards for the index (default: 1) */
+    numberOfShards?: number;
+    /** Number of replicas for the index (default: 1) */
+    numberOfReplicas?: number;
+    /** Custom analyzers for this index */
+    analyzers?: Record<string, ESAnalyzerConfig>;
+    /** Per-property field mapping overrides */
+    fieldOverrides?: Record<string, ESFieldOverride>;
+    /** Properties to exclude from the index (by name) */
+    excludeFields?: string[];
+    /** Whether to include computed properties (default: false) */
+    includeComputedProperties?: boolean;
+}
+/** Custom analyzer configuration for text analysis. */
+export interface ESAnalyzerConfig {
+    /** Analyzer type */
+    type: 'standard' | 'simple' | 'whitespace' | 'custom';
+    /** Tokenizer (required for custom analyzers) */
+    tokenizer?: string;
+    /** Token filters to apply */
+    filter?: string[];
+}
+/** Ingest pipeline processor configuration. */
+export interface ESIngestPipelineProcessor {
+    /** Processor type (e.g. "set", "rename", "script", "date") */
+    type: string;
+    /** Processor-specific configuration */
+    [key: string]: unknown;
+}
+/** Ingest pipeline definition for transforming documents before indexing. */
+export interface ESIngestPipeline {
+    /** Pipeline identifier */
+    id: string;
+    /** Pipeline description */
+    description?: string;
+    /** Ordered list of processors to apply */
+    processors: ESIngestPipelineProcessor[];
+}
+/** Configuration for the outbox-driven indexer worker. */
+export interface ESIndexerConfig {
+    /** Batch size for bulk indexing (default: 100) */
+    batchSize?: number;
+    /** Refresh policy after bulk operations (default: "false") */
+    refresh?: 'true' | 'false' | 'wait_for';
+    /** Elasticsearch endpoint URL */
+    endpoint?: string;
+    /** Index name prefix (default: empty) */
+    indexPrefix?: string;
+    /** Whether to emit retry logic (default: true) */
+    enableRetry?: boolean;
+    /** Maximum retry attempts (default: 3) */
+    maxRetries?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/manifest/projections/elasticsearch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/elasticsearch/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6EAA6E;AAC7E,MAAM,WAAW,4BAA4B;IAC3C,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACjD,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,8DAA8D;IAC9D,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;IACtD,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,UAAU,EAAE,yBAAyB,EAAE,CAAC;CACzC;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/manifest/projections/elasticsearch/types.js

@@ -0,0 +1,10 @@
+/**
+ * Type definitions for the Elasticsearch projection.
+ *
+ * All search-specific concepts (index settings, analyzer configurations,
+ * field overrides, pipeline definitions) are declared here. None of these
+ * enter Manifest core grammar or IR — they arrive via projection options
+ * or are inferred deterministically from IR.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/manifest/projections/elasticsearch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/manifest/projections/elasticsearch/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/manifest/projections/express/generator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Express/Fastify projection for Manifest IR.
+ *
+ * Generates standalone router modules with typed request/response shapes,
+ * auth middleware integration, and optional Zod request validation against
+ * command parameter schemas.
+ *
+ * Surfaces:
+ *   - express.router    → Complete router module with all entity routes
+ *   - express.entity    → Single-entity router (entity-scoped)
+ *   - express.types     → TypeScript request/response type definitions
+ *   - express.all       → All surfaces combined
+ *
+ * The projection supports both Express and Fastify via the `framework` option.
+ * Default is Express.
+ */
+import type { IR } from '../../ir';
+import type { ProjectionTarget, ProjectionRequest, ProjectionResult } from '../interface';
+/**
+ * Express/Fastify route handler projection.
+ *
+ * Generates standalone router modules from Manifest IR with:
+ * - Typed request/response shapes
+ * - Auth middleware integration
+ * - Optional Zod request validation
+ * - Command dispatch through the Manifest runtime
+ *
+ * Supports both Express (Router) and Fastify (plugin) via the
+ * `framework` option.
+ */
+export declare class ExpressProjection implements ProjectionTarget {
+    readonly name = "express";
+    readonly description = "Express/Fastify route handlers and middleware from IR entities and commands";
+    readonly surfaces: readonly ["express.router", "express.entity", "express.types", "express.all"];
+    generate(ir: IR, request: ProjectionRequest): ProjectionResult;
+}
+export type { ExpressProjectionOptions } from './types';
+//# sourceMappingURL=generator.d.ts.map

package/dist/manifest/projections/express/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/express/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,EAAE,EAOH,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,cAAc,CAAC;AAwmBtB;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,iFAAiF;IACrG,QAAQ,CAAC,QAAQ,gFAAY;IAE7B,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;CA4G/D;AAGD,YAAY,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC"}