@soulbatical/tetra-core 0.1.13 → 0.1.15

package/dist/generators/rpc/templates/enum.js

@@ -0,0 +1,93 @@
+/**
+ * Enum Filter Template
+ * For filters with predefined values (status, phase, etc.)
+ */
+import { escapeIdentifier, getTableAlias } from '../utils.js';
+/**
+ * Generate WHERE clause for enum filter
+ *
+ * @example
+ * // Input: { name: 'status', column: 'status', values: ['paid', 'pending'] }
+ * // Output: AND (p_status IS NULL OR p_status = 'all' OR status = p_status)
+ */
+export function generateEnumWhere(filter, tableName, aliasMap) {
+    const paramName = `p_${filter.rpcParam || filter.name}`;
+    const column = escapeIdentifier(filter.column);
+    const alias = getTableAlias(tableName, aliasMap);
+    // Check if this is a boolean column with mapping
+    const booleanMapping = filter.sqlGeneration?.booleanMapping;
+    if (booleanMapping) {
+        // Generate conditions for boolean mapping (e.g., 'yes' → true, 'no' → false)
+        const conditions = Object.entries(booleanMapping)
+            .map(([textValue, boolValue]) => `(${paramName} = '${textValue}' AND ${alias}.${column} = ${boolValue})`)
+            .join('\n         OR ');
+        return `
+      -- ${filter.name} (enum filter - boolean column)
+      AND (
+        ${paramName} IS NULL OR ${paramName} = 'all'
+        OR ${conditions}
+      )`;
+    }
+    return `
+      -- ${filter.name} (enum filter)
+      AND (${paramName} IS NULL OR ${paramName} = 'all' OR ${alias}.${column}::text = ${paramName})`;
+}
+/**
+ * Generate counts query for enum filter
+ * Uses UNION ALL pattern to ensure all values are present (even with count 0)
+ *
+ * @example
+ * // Input: { name: 'status', values: ['paid', 'pending', 'cancelled'] }
+ * // Output:
+ * // 'byStatus', (
+ * //   SELECT jsonb_object_agg(status_value, cnt)
+ * //   FROM (
+ * //     SELECT 'paid' as status_value, COUNT(*)::int as cnt FROM filtered_items WHERE status = 'paid'
+ * //     UNION ALL
+ * //     SELECT 'pending' as status_value, COUNT(*)::int as cnt FROM filtered_items WHERE status = 'pending'
+ * //     UNION ALL
+ * //     SELECT 'cancelled' as status_value, COUNT(*)::int as cnt FROM filtered_items WHERE status = 'cancelled'
+ * //   )
+ * // )
+ */
+export function generateEnumCounts(filter) {
+    const countsKey = filter.countsKey || `by${filter.name.charAt(0).toUpperCase()}${filter.name.slice(1)}`;
+    let column = filter.column;
+    // Map joined columns to CTE aliases
+    if (column === 'o.status') {
+        column = 'order_status';
+    }
+    else if (column === 'o.source') {
+        column = 'order_source';
+    }
+    else {
+        column = escapeIdentifier(column);
+    }
+    if (!filter.values || filter.values.length === 0) {
+        throw new Error(`Enum filter "${filter.name}" missing values array`);
+    }
+    // Check if this is a boolean column with mapping
+    const booleanMapping = filter.sqlGeneration?.booleanMapping;
+    // Generate UNION ALL queries for each value
+    const unionQueries = filter.values.map(value => {
+        if (booleanMapping && booleanMapping[value] !== undefined) {
+            // Boolean column - compare with true/false
+            const boolValue = booleanMapping[value];
+            return `      SELECT '${value}' as ${filter.name}_value, COUNT(*)::int as cnt
+      FROM filtered_items WHERE ${column} = ${boolValue}`;
+        }
+        else {
+            // Regular text/enum column - compare with string (cast to text for enum types)
+            return `      SELECT '${value}' as ${filter.name}_value, COUNT(*)::int as cnt
+      FROM filtered_items WHERE ${column}::text = '${value}'`;
+        }
+    }).join('\n      UNION ALL\n');
+    return `
+    '${countsKey}', (
+      SELECT jsonb_object_agg(${filter.name}_value, cnt)
+      FROM (
+${unionQueries}
+      ) subquery
+    )`;
+}
+//# sourceMappingURL=enum.js.map

package/dist/generators/rpc/templates/enum.js.map

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

package/dist/generators/rpc/templates/nullable.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Nullable Filter Template
+ * For filters checking if field has value or is NULL (user presence, etc.)
+ */
+import { FilterConfig } from '../../../shared/types/feature-config.js';
+/**
+ * Generate WHERE clause for nullable filter
+ *
+ * @example
+ * // Input: { name: 'user', column: 'user_id' }
+ * // Output:
+ * // AND (
+ * //   p_user IS NULL OR p_user = 'all'
+ * //   OR (p_user = 'with' AND user_id IS NOT NULL)
+ * //   OR (p_user = 'without' AND user_id IS NULL)
+ * // )
+ */
+export declare function generateNullableWhere(filter: FilterConfig, tableName: string, aliasMap?: Record<string, string>): string;
+/**
+ * Generate counts query for nullable filter
+ *
+ * @example
+ * // Input: { name: 'user', column: 'user_id' }
+ * // Output:
+ * // 'byUser', jsonb_build_object(
+ * //   'with', (SELECT COUNT(*)::int FROM filtered_items WHERE user_id IS NOT NULL),
+ * //   'without', (SELECT COUNT(*)::int FROM filtered_items WHERE user_id IS NULL)
+ * // )
+ */
+export declare function generateNullableCounts(filter: FilterConfig): string;
+//# sourceMappingURL=nullable.d.ts.map

package/dist/generators/rpc/templates/nullable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullable.d.ts","sourceRoot":"","sources":["../../../../src/generators/rpc/templates/nullable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAYxH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CASnE"}

package/dist/generators/rpc/templates/nullable.js

@@ -0,0 +1,50 @@
+/**
+ * Nullable Filter Template
+ * For filters checking if field has value or is NULL (user presence, etc.)
+ */
+import { escapeIdentifier, getTableAlias } from '../utils.js';
+/**
+ * Generate WHERE clause for nullable filter
+ *
+ * @example
+ * // Input: { name: 'user', column: 'user_id' }
+ * // Output:
+ * // AND (
+ * //   p_user IS NULL OR p_user = 'all'
+ * //   OR (p_user = 'with' AND user_id IS NOT NULL)
+ * //   OR (p_user = 'without' AND user_id IS NULL)
+ * // )
+ */
+export function generateNullableWhere(filter, tableName, aliasMap) {
+    const paramName = `p_${filter.rpcParam || filter.name}`;
+    const column = escapeIdentifier(filter.column);
+    const alias = getTableAlias(tableName, aliasMap);
+    return `
+      -- ${filter.name} (nullable filter - with/without)
+      AND (
+        ${paramName} IS NULL OR ${paramName} = 'all'
+        OR (${paramName} = 'with' AND ${alias}.${column} IS NOT NULL)
+        OR (${paramName} = 'without' AND ${alias}.${column} IS NULL)
+      )`;
+}
+/**
+ * Generate counts query for nullable filter
+ *
+ * @example
+ * // Input: { name: 'user', column: 'user_id' }
+ * // Output:
+ * // 'byUser', jsonb_build_object(
+ * //   'with', (SELECT COUNT(*)::int FROM filtered_items WHERE user_id IS NOT NULL),
+ * //   'without', (SELECT COUNT(*)::int FROM filtered_items WHERE user_id IS NULL)
+ * // )
+ */
+export function generateNullableCounts(filter) {
+    const countsKey = filter.countsKey || `by${filter.name.charAt(0).toUpperCase()}${filter.name.slice(1)}`;
+    const column = escapeIdentifier(filter.column);
+    return `
+    '${countsKey}', jsonb_build_object(
+      'with', (SELECT COUNT(*)::int FROM filtered_items WHERE ${column} IS NOT NULL),
+      'without', (SELECT COUNT(*)::int FROM filtered_items WHERE ${column} IS NULL)
+    )`;
+}
+//# sourceMappingURL=nullable.js.map

package/dist/generators/rpc/templates/nullable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullable.js","sourceRoot":"","sources":["../../../../src/generators/rpc/templates/nullable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB,EAAE,SAAiB,EAAE,QAAiC;IAC9G,MAAM,SAAS,GAAG,KAAK,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAO,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEjD,OAAO;WACE,MAAM,CAAC,IAAI;;UAEZ,SAAS,eAAe,SAAS;cAC7B,SAAS,iBAAiB,KAAK,IAAI,MAAM;cACzC,SAAS,oBAAoB,KAAK,IAAI,MAAM;QAClD,CAAC;AACT,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAO,CAAC,CAAC;IAEhD,OAAO;OACF,SAAS;gEACgD,MAAM;mEACH,MAAM;MACnE,CAAC;AACP,CAAC"}

package/dist/generators/rpc/templates/related.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Related Filter Template
+ * For filters checking relationship existence (voucher, production, etc.)
+ */
+import { FilterConfig } from '../../../shared/types/feature-config.js';
+/**
+ * Generate WHERE clause for related filter
+ * Uses EXISTS/NOT EXISTS subqueries
+ *
+ * @example
+ * // Input:
+ * // {
+ * //   name: 'voucher',
+ * //   relatedTable: 'orderitems',
+ * //   foreignKey: 'orderid',
+ * //   sqlGeneration: {
+ * //     joins: [
+ * //       { table: 'orderitems oi', on: 'oi.orderid = o.id', type: 'LEFT' },
+ * //       { table: 'vouchers v', on: 'v.orderitemid = oi.id', type: 'LEFT' }
+ * //     ]
+ * //   }
+ * // }
+ * //
+ * // Output:
+ * // AND (
+ * //   p_voucher IS NULL OR p_voucher = 'all'
+ * //   OR (p_voucher = 'with' AND EXISTS (
+ * //     SELECT 1 FROM vouchers v
+ * //     JOIN orderitems oi ON v.orderitemid = oi.id
+ * //     WHERE oi.orderid = o.id
+ * //   ))
+ * //   OR (p_voucher = 'without' AND NOT EXISTS (...))
+ * // )
+ */
+export declare function generateRelatedWhere(filter: FilterConfig, tableName: string, aliasMap?: Record<string, string>): string;
+/**
+ * Generate counts query for related filter
+ *
+ * @example
+ * // Output:
+ * // 'byVoucher', jsonb_build_object(
+ * //   'with', (SELECT COUNT(*)::int FROM filtered_items WHERE EXISTS (...)),
+ * //   'without', (SELECT COUNT(*)::int FROM filtered_items WHERE NOT EXISTS (...))
+ * // )
+ */
+export declare function generateRelatedCounts(filter: FilterConfig, tableName: string, aliasMap?: Record<string, string>): string;
+//# sourceMappingURL=related.d.ts.map

package/dist/generators/rpc/templates/related.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related.d.ts","sourceRoot":"","sources":["../../../../src/generators/rpc/templates/related.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAcvH;AA8ED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAUxH"}

package/dist/generators/rpc/templates/related.js

@@ -0,0 +1,182 @@
+/**
+ * Related Filter Template
+ * For filters checking relationship existence (voucher, production, etc.)
+ */
+import { getTableAlias } from '../utils.js';
+/**
+ * Generate WHERE clause for related filter
+ * Uses EXISTS/NOT EXISTS subqueries
+ *
+ * @example
+ * // Input:
+ * // {
+ * //   name: 'voucher',
+ * //   relatedTable: 'orderitems',
+ * //   foreignKey: 'orderid',
+ * //   sqlGeneration: {
+ * //     joins: [
+ * //       { table: 'orderitems oi', on: 'oi.orderid = o.id', type: 'LEFT' },
+ * //       { table: 'vouchers v', on: 'v.orderitemid = oi.id', type: 'LEFT' }
+ * //     ]
+ * //   }
+ * // }
+ * //
+ * // Output:
+ * // AND (
+ * //   p_voucher IS NULL OR p_voucher = 'all'
+ * //   OR (p_voucher = 'with' AND EXISTS (
+ * //     SELECT 1 FROM vouchers v
+ * //     JOIN orderitems oi ON v.orderitemid = oi.id
+ * //     WHERE oi.orderid = o.id
+ * //   ))
+ * //   OR (p_voucher = 'without' AND NOT EXISTS (...))
+ * // )
+ */
+export function generateRelatedWhere(filter, tableName, aliasMap) {
+    const paramName = `p_${filter.rpcParam || filter.name}`;
+    const alias = getTableAlias(tableName, aliasMap);
+    // Check for custom joins configuration
+    const joins = filter.sqlGeneration?.joins;
+    if (joins && joins.length > 0) {
+        // Complex related filter with custom joins
+        return generateComplexRelatedWhere(filter, tableName, alias, paramName, joins);
+    }
+    // Simple related filter (single table JOIN)
+    return generateSimpleRelatedWhere(filter, alias, paramName);
+}
+/**
+ * Generate simple related WHERE clause (single table)
+ * v3.11: Add public. prefix for Postgres v17 compatibility
+ */
+function generateSimpleRelatedWhere(filter, alias, paramName) {
+    const relatedTable = filter.relatedTable;
+    const foreignKey = filter.foreignKey;
+    return `
+      -- ${filter.name} (related filter - with/without)
+      AND (
+        ${paramName} IS NULL OR ${paramName} = 'all'
+        OR (${paramName} = 'with' AND EXISTS (
+          SELECT 1 FROM public.${relatedTable}
+          WHERE ${foreignKey} = ${alias}.id
+        ))
+        OR (${paramName} = 'without' AND NOT EXISTS (
+          SELECT 1 FROM public.${relatedTable}
+          WHERE ${foreignKey} = ${alias}.id
+        ))
+      )`;
+}
+/**
+ * Generate complex related WHERE clause (multiple JOINs)
+ * v3.11: Add public. prefix for Postgres v17 compatibility
+ */
+function generateComplexRelatedWhere(filter, _tableName, _alias, paramName, joins) {
+    // Build JOIN chain - add public. prefix to table names
+    const firstJoin = joins[0];
+    const firstJoinTable = addPublicPrefix(firstJoin.table);
+    const remainingJoins = joins.slice(1);
+    const joinChain = remainingJoins
+        .map(join => `          ${join.type} JOIN ${addPublicPrefix(join.table)} ON ${join.on}`)
+        .join('\n');
+    return `
+      -- ${filter.name} (related filter - complex with joins)
+      AND (
+        ${paramName} IS NULL OR ${paramName} = 'all'
+        OR (${paramName} = 'with' AND EXISTS (
+          SELECT 1 FROM ${firstJoinTable}
+${joinChain}
+          WHERE ${firstJoin.on}
+        ))
+        OR (${paramName} = 'without' AND NOT EXISTS (
+          SELECT 1 FROM ${firstJoinTable}
+${joinChain}
+          WHERE ${firstJoin.on}
+        ))
+      )`;
+}
+/**
+ * Add public. prefix to table reference (handles "tablename alias" format)
+ */
+function addPublicPrefix(tableWithAlias) {
+    // Handle "tablename alias" format (e.g., "orderitems oi" → "public.orderitems oi")
+    const parts = tableWithAlias.trim().split(/\s+/);
+    if (parts.length >= 1) {
+        parts[0] = `public.${parts[0]}`;
+    }
+    return parts.join(' ');
+}
+/**
+ * Generate counts query for related filter
+ *
+ * @example
+ * // Output:
+ * // 'byVoucher', jsonb_build_object(
+ * //   'with', (SELECT COUNT(*)::int FROM filtered_items WHERE EXISTS (...)),
+ * //   'without', (SELECT COUNT(*)::int FROM filtered_items WHERE NOT EXISTS (...))
+ * // )
+ */
+export function generateRelatedCounts(filter, tableName, aliasMap) {
+    const countsKey = filter.countsKey || `by${filter.name.charAt(0).toUpperCase()}${filter.name.slice(1)}`;
+    const alias = getTableAlias(tableName, aliasMap);
+    const joins = filter.sqlGeneration?.joins;
+    if (joins && joins.length > 0) {
+        return generateComplexRelatedCounts(filter, countsKey, alias, joins);
+    }
+    return generateSimpleRelatedCounts(filter, countsKey, alias);
+}
+/**
+ * Generate simple related counts (single table)
+ * v3.11: Add public. prefix for Postgres v17 compatibility
+ */
+function generateSimpleRelatedCounts(filter, countsKey, alias) {
+    const relatedTable = filter.relatedTable;
+    const foreignKey = filter.foreignKey;
+    return `
+    '${countsKey}', jsonb_build_object(
+      'with', (
+        SELECT COUNT(*)::int FROM filtered_items ${alias}
+        WHERE EXISTS (
+          SELECT 1 FROM public.${relatedTable}
+          WHERE ${foreignKey} = ${alias}.id
+        )
+      ),
+      'without', (
+        SELECT COUNT(*)::int FROM filtered_items ${alias}
+        WHERE NOT EXISTS (
+          SELECT 1 FROM public.${relatedTable}
+          WHERE ${foreignKey} = ${alias}.id
+        )
+      )
+    )`;
+}
+/**
+ * Generate complex related counts (multiple JOINs)
+ * v3.11: Add public. prefix for Postgres v17 compatibility
+ */
+function generateComplexRelatedCounts(filter, countsKey, alias, joins) {
+    const firstJoin = joins[0];
+    const firstJoinTable = addPublicPrefix(firstJoin.table);
+    const remainingJoins = joins.slice(1);
+    const joinChain = remainingJoins
+        .map(join => `          ${join.type} JOIN ${addPublicPrefix(join.table)} ON ${join.on}`)
+        .join('\n');
+    return `
+    '${countsKey}', jsonb_build_object(
+      'with', (
+        SELECT COUNT(*)::int FROM filtered_items ${alias}
+        WHERE EXISTS (
+          SELECT 1 FROM ${firstJoinTable}
+${joinChain}
+          WHERE ${firstJoin.on}
+        )
+      ),
+      'without', (
+        SELECT COUNT(*)::int FROM filtered_items ${alias}
+        WHERE NOT EXISTS (
+          SELECT 1 FROM ${firstJoinTable}
+${joinChain}
+          WHERE ${firstJoin.on}
+        )
+      )
+    )`;
+}
+//# sourceMappingURL=related.js.map

package/dist/generators/rpc/templates/related.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"related.js","sourceRoot":"","sources":["../../../../src/generators/rpc/templates/related.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB,EAAE,SAAiB,EAAE,QAAiC;IAC7G,MAAM,SAAS,GAAG,KAAK,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEjD,uCAAuC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC;IAE1C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,2CAA2C;QAC3C,OAAO,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACjF,CAAC;IAED,4CAA4C;IAC5C,OAAO,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,SAAS,0BAA0B,CACjC,MAAoB,EACpB,KAAa,EACb,SAAiB;IAEjB,MAAM,YAAY,GAAG,MAAM,CAAC,YAAa,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAW,CAAC;IAEtC,OAAO;WACE,MAAM,CAAC,IAAI;;UAEZ,SAAS,eAAe,SAAS;cAC7B,SAAS;iCACU,YAAY;kBAC3B,UAAU,MAAM,KAAK;;cAEzB,SAAS;iCACU,YAAY;kBAC3B,UAAU,MAAM,KAAK;;QAE/B,CAAC;AACT,CAAC;AAED;;;GAGG;AACH,SAAS,2BAA2B,CAClC,MAAoB,EACpB,UAAkB,EAClB,MAAc,EACd,SAAiB,EACjB,KAA6E;IAE7E,uDAAuD;IACvD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,cAAc,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,cAAc;SAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,IAAI,CAAC,IAAI,SAAS,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC;SACvF,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;WACE,MAAM,CAAC,IAAI;;UAEZ,SAAS,eAAe,SAAS;cAC7B,SAAS;0BACG,cAAc;EACtC,SAAS;kBACO,SAAS,CAAC,EAAE;;cAEhB,SAAS;0BACG,cAAc;EACtC,SAAS;kBACO,SAAS,CAAC,EAAE;;QAEtB,CAAC;AACT,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,cAAsB;IAC7C,mFAAmF;IACnF,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB,EAAE,SAAiB,EAAE,QAAiC;IAC9G,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC;IAE1C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAS,2BAA2B,CAClC,MAAoB,EACpB,SAAiB,EACjB,KAAa;IAEb,MAAM,YAAY,GAAG,MAAM,CAAC,YAAa,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAW,CAAC;IAEtC,OAAO;OACF,SAAS;;mDAEmC,KAAK;;iCAEvB,YAAY;kBAC3B,UAAU,MAAM,KAAK;;;;mDAIY,KAAK;;iCAEvB,YAAY;kBAC3B,UAAU,MAAM,KAAK;;;MAGjC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,SAAS,4BAA4B,CACnC,MAAoB,EACpB,SAAiB,EACjB,KAAa,EACb,KAA6E;IAE7E,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,cAAc,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,cAAc;SAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,IAAI,CAAC,IAAI,SAAS,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC;SACvF,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;OACF,SAAS;;mDAEmC,KAAK;;0BAE9B,cAAc;EACtC,SAAS;kBACO,SAAS,CAAC,EAAE;;;;mDAIqB,KAAK;;0BAE9B,cAAc;EACtC,SAAS;kBACO,SAAS,CAAC,EAAE;;;MAGxB,CAAC;AACP,CAAC"}

package/dist/generators/rpc/templates/search.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Search Filter Template
+ * For multi-field text search filters
+ */
+import { FilterConfig } from '../../../shared/types/feature-config.js';
+/**
+ * Generate WHERE clause for search filter
+ * Uses ILIKE for case-insensitive search + pg_trgm for fuzzy matching
+ *
+ * Features:
+ * - ILIKE: Fast wildcard search (e.g., 'test' finds 'Test Product')
+ * - pg_trgm similarity: Fuzzy matching (e.g., 'tst' finds 'test')
+ * - Threshold: 0.2 for trigram similarity (lower = more fuzzy)
+ *
+ * @example
+ * // Input:
+ * // {
+ * //   name: 'search',
+ * //   sqlGeneration: {
+ * //     searchFields: ['reference', 'first_name', 'last_name', 'user_email']
+ * //   }
+ * // }
+ * //
+ * // Output:
+ * // AND (
+ * //   p_search IS NULL OR p_search = '' OR p_search = 'all'
+ * //   OR (
+ * //     o.reference ILIKE '%' || p_search || '%'
+ * //     OR similarity(o.reference, p_search) > 0.2
+ * //     OR o.first_name ILIKE '%' || p_search || '%'
+ * //     OR similarity(o.first_name, p_search) > 0.2
+ * //     ...
+ * //   )
+ * // )
+ */
+export declare function generateSearchWhere(filter: FilterConfig, tableName: string, aliasMap?: Record<string, string>): string;
+/**
+ * Search filters don't have counts (no aggregation needed)
+ * Returns empty string
+ */
+export declare function generateSearchCounts(_filter: FilterConfig): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/generators/rpc/templates/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/generators/rpc/templates/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAwCtH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAElE"}

package/dist/generators/rpc/templates/search.js

@@ -0,0 +1,81 @@
+/**
+ * Search Filter Template
+ * For multi-field text search filters
+ */
+import { escapeIdentifier, getTableAlias } from '../utils.js';
+/**
+ * Generate WHERE clause for search filter
+ * Uses ILIKE for case-insensitive search + pg_trgm for fuzzy matching
+ *
+ * Features:
+ * - ILIKE: Fast wildcard search (e.g., 'test' finds 'Test Product')
+ * - pg_trgm similarity: Fuzzy matching (e.g., 'tst' finds 'test')
+ * - Threshold: 0.2 for trigram similarity (lower = more fuzzy)
+ *
+ * @example
+ * // Input:
+ * // {
+ * //   name: 'search',
+ * //   sqlGeneration: {
+ * //     searchFields: ['reference', 'first_name', 'last_name', 'user_email']
+ * //   }
+ * // }
+ * //
+ * // Output:
+ * // AND (
+ * //   p_search IS NULL OR p_search = '' OR p_search = 'all'
+ * //   OR (
+ * //     o.reference ILIKE '%' || p_search || '%'
+ * //     OR similarity(o.reference, p_search) > 0.2
+ * //     OR o.first_name ILIKE '%' || p_search || '%'
+ * //     OR similarity(o.first_name, p_search) > 0.2
+ * //     ...
+ * //   )
+ * // )
+ */
+export function generateSearchWhere(filter, tableName, aliasMap) {
+    const paramName = `p_${filter.rpcParam || filter.name}`;
+    const alias = getTableAlias(tableName, aliasMap);
+    // Get search fields from sqlGeneration config
+    const searchFields = filter.sqlGeneration?.searchFields;
+    if (!searchFields || searchFields.length === 0) {
+        throw new Error(`Search filter "${filter.name}" missing searchFields in sqlGeneration config`);
+    }
+    // Generate ILIKE + similarity conditions for each field
+    // Support format: 'field' or 'relation.field' (e.g., 'user.firstname')
+    // v3.11: Use extensions.similarity() for Postgres v17 compatibility (pg_trgm is in extensions schema)
+    const searchCond = searchFields
+        .map(field => {
+        if (field.includes('.')) {
+            // Relational field (e.g., 'user.firstname')
+            const [relation, relField] = field.split('.');
+            const relAlias = relation.substring(0, 1); // 'u' for 'user'
+            const escapedField = escapeIdentifier(relField);
+            // Both ILIKE (exact substring) AND fuzzy similarity
+            return `        ${relAlias}.${escapedField} ILIKE '%' || ${paramName} || '%'\n        OR extensions.similarity(${relAlias}.${escapedField}, ${paramName}) > 0.2`;
+        }
+        else {
+            // Direct field on main table
+            const escapedField = escapeIdentifier(field);
+            // Both ILIKE (exact substring) AND fuzzy similarity
+            return `        ${alias}.${escapedField} ILIKE '%' || ${paramName} || '%'\n        OR extensions.similarity(${alias}.${escapedField}, ${paramName}) > 0.2`;
+        }
+    })
+        .join('\n        OR ');
+    return `
+      -- ${filter.name} (search filter - ILIKE + fuzzy matching with pg_trgm)
+      AND (
+        ${paramName} IS NULL OR ${paramName} = '' OR ${paramName} = 'all'
+        OR (
+${searchCond}
+        )
+      )`;
+}
+/**
+ * Search filters don't have counts (no aggregation needed)
+ * Returns empty string
+ */
+export function generateSearchCounts(_filter) {
+    return ''; // Search filters don't generate counts
+}
+//# sourceMappingURL=search.js.map

package/dist/generators/rpc/templates/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../src/generators/rpc/templates/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoB,EAAE,SAAiB,EAAE,QAAiC;IAC5G,MAAM,SAAS,GAAG,KAAK,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEjD,8CAA8C;IAC9C,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC;IAExD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,IAAI,gDAAgD,CAAC,CAAC;IACjG,CAAC;IAED,wDAAwD;IACxD,uEAAuE;IACvE,sGAAsG;IACtG,MAAM,UAAU,GAAG,YAAY;SAC5B,GAAG,CAAC,KAAK,CAAC,EAAE;QACX,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,4CAA4C;YAC5C,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,iBAAiB;YAC5D,MAAM,YAAY,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAChD,oDAAoD;YACpD,OAAO,WAAW,QAAQ,IAAI,YAAY,iBAAiB,SAAS,6CAA6C,QAAQ,IAAI,YAAY,KAAK,SAAS,SAAS,CAAC;QACnK,CAAC;aAAM,CAAC;YACN,6BAA6B;YAC7B,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC7C,oDAAoD;YACpD,OAAO,WAAW,KAAK,IAAI,YAAY,iBAAiB,SAAS,6CAA6C,KAAK,IAAI,YAAY,KAAK,SAAS,SAAS,CAAC;QAC7J,CAAC;IACH,CAAC,CAAC;SACD,IAAI,CAAC,eAAe,CAAC,CAAC;IAEzB,OAAO;WACE,MAAM,CAAC,IAAI;;UAEZ,SAAS,eAAe,SAAS,YAAY,SAAS;;EAE9D,UAAU;;QAEJ,CAAC;AACT,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IACxD,OAAO,EAAE,CAAC,CAAC,uCAAuC;AACpD,CAAC"}

package/dist/generators/rpc/templates/time.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Time Filter Template
+ * For filters based on date ranges (this-week, this-month, older)
+ */
+import { FilterConfig } from '../../../shared/types/feature-config.js';
+/**
+ * Generate WHERE clause for time filter
+ *
+ * @example
+ * // Input:
+ * // {
+ * //   name: 'time_period',
+ * //   dateField: 'order_date',
+ * //   sqlGeneration: {
+ * //     timePeriods: {
+ * //       thisWeek: { interval: '7 days', operator: '>=' },
+ * //       thisMonth: { interval: '30 days', operator: '>=' },
+ * //       older: { interval: '30 days', operator: '<' }
+ * //     }
+ * //   }
+ * // }
+ * //
+ * // Output:
+ * // AND (
+ * //   p_time_period IS NULL OR p_time_period = 'all'
+ * //   OR (p_time_period = 'thisWeek' AND order_date >= CURRENT_DATE - INTERVAL '7 days')
+ * //   OR (p_time_period = 'thisMonth' AND order_date >= CURRENT_DATE - INTERVAL '30 days')
+ * //   OR (p_time_period = 'older' AND order_date < CURRENT_DATE - INTERVAL '30 days')
+ * // )
+ */
+export declare function generateTimeWhere(filter: FilterConfig, tableName: string, aliasMap?: Record<string, string>): string;
+/**
+ * Generate counts query for time filter
+ *
+ * @example
+ * // Output:
+ * // 'byTimePeriod', jsonb_build_object(
+ * //   'thisWeek', (SELECT COUNT(*)::int FROM filtered_items WHERE order_date >= CURRENT_DATE - INTERVAL '7 days'),
+ * //   'thisMonth', (SELECT COUNT(*)::int FROM filtered_items WHERE order_date >= CURRENT_DATE - INTERVAL '30 days'),
+ * //   'older', (SELECT COUNT(*)::int FROM filtered_items WHERE order_date < CURRENT_DATE - INTERVAL '30 days')
+ * // )
+ */
+export declare function generateTimeCounts(filter: FilterConfig): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/generators/rpc/templates/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../../src/generators/rpc/templates/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAcpH;AAgDD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAa/D"}