@soulbatical/tetra-core 0.1.13 → 0.1.15

package/dist/generators/rpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/rpc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC3G,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,MAAM,GACP,MAAM,YAAY,CAAC"}

package/dist/generators/rpc/index.js

@@ -0,0 +1,20 @@
+/**
+ * RPC Generator — Auto-generates SQL RPC functions from FeatureConfig
+ *
+ * Usage:
+ * ```typescript
+ * import { RPCGenerator, DetailRPCGenerator, validateConfig } from '@soulbatical/tetra-core';
+ *
+ * const generator = new RPCGenerator(ordersFeatureConfig, {
+ *   aliasMap: { orders: 'o', orderitems: 'oi' },
+ * });
+ * const { resultsSQL, countsSQL } = generator.generate();
+ * generator.writeMigrations({ force: true });
+ * ```
+ */
+export { RPCGenerator } from './rpc-generator.js';
+export { DetailRPCGenerator } from './detail-rpc-generator.js';
+export { validateConfig } from './validator.js';
+export { generateAuthCheck, generateAuthWhereClause, generateAuthDeclarations } from './templates/auth.js';
+export { generateTimestamp, getTableAlias, escapeIdentifier, capitalize, kebabToCamelCase, snakeToCamelCase, filterNameToCountsKey, indent, } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/generators/rpc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/rpc/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG3G,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,MAAM,GACP,MAAM,YAAY,CAAC"}

package/dist/generators/rpc/rpc-generator.d.ts

@@ -0,0 +1,150 @@
+/**
+ * RPC Generator
+ * Auto-generates SQL RPC functions from FeatureConfig
+ *
+ * This is the core of the SQL Generator system. It takes a FeatureConfig
+ * and generates two SQL migration files:
+ * 1. get_<table>_results.sql - Results function (paginated, with includes)
+ * 2. get_<table>_counts.sql - Counts function (filter breakdowns)
+ *
+ * Usage:
+ * const generator = new RPCGenerator(ordersFeatureConfig);
+ * const { resultsSQL, countsSQL } = generator.generate();
+ * generator.writeMigrations();
+ */
+import { FeatureConfig, FilterConfig } from '../../shared/types/feature-config.js';
+export interface GeneratedSQL {
+    resultsSQL: string;
+    countsSQL: string;
+    filterSQL?: string;
+}
+export interface FilterDefinition extends FilterConfig {
+    paramName: string;
+    paramType: string;
+}
+export interface RPCGeneratorOptions {
+    /** Custom table alias map (e.g., { orders: 'o', orderitems: 'oi' }) */
+    aliasMap?: Record<string, string>;
+    /** User ID column name (default: 'user_id') */
+    userIdColumn?: string;
+    /** Search join config: map relation names to JOIN clauses */
+    searchJoins?: Record<string, (tableAlias: string) => string>;
+}
+export declare class RPCGenerator {
+    private config;
+    private tableName;
+    private tableAlias;
+    private aliasMap?;
+    private userIdColumn;
+    private searchJoins;
+    private readonly GENERATOR_VERSION;
+    private readonly ENABLE_RPC_INCLUDES;
+    constructor(config: FeatureConfig, options?: RPCGeneratorOptions);
+    /**
+     * Format validation errors for display
+     */
+    private formatValidationErrors;
+    /**
+     * Parse filters from config
+     */
+    parseFilters(): FilterDefinition[];
+    /**
+     * Get SQL parameter type for filter
+     */
+    private getParamType;
+    /**
+     * Generate filter function signature
+     */
+    generateFilterSignature(): string;
+    /**
+     * Generate org WHERE clause (includes system content where organization_id IS NULL)
+     */
+    private generateOrgWhereClause;
+    /**
+     * Generate WHERE clause for a filter
+     */
+    generateWhereClause(filter: FilterConfig): string;
+    /**
+     * Generate all WHERE clauses
+     */
+    generateWhereClauses(): string;
+    /**
+     * Generate ORDER BY clause
+     */
+    generateOrderBy(): string;
+    /**
+     * Detect required JOINs from searchFields
+     * v3.11: Add public. prefix for Postgres v17 compatibility
+     * v3.14: Also check filter-level searchFields (filter.sqlGeneration.searchFields)
+     */
+    private detectJoins;
+    /**
+     * Generate complete filter function SQL
+     */
+    generateFilterFunction(): string;
+    /**
+     * Generate counts query for a filter
+     */
+    generateCountsQuery(filter: FilterConfig): string;
+    /**
+     * Generate all counts queries
+     */
+    generateCountsQueries(): string;
+    /**
+     * Generate counts function signature
+     */
+    generateCountsSignature(): string;
+    /**
+     * Generate complete counts function SQL
+     */
+    generateCountsFunction(): string;
+    /**
+     * Generate JSONB aggregates for includes (v3.5)
+     * Returns LATERAL JOIN subqueries that aggregate related records as JSONB arrays
+     */
+    private generateIncludeJoins;
+    /**
+     * Extract column name from foreign key constraint name
+     * Example: 'orders_user_id_fkey' → 'user_id'
+     *          'users_public_active_organization_id_fkey' → 'active_organization_id'
+     */
+    private getForeignKeyColumn;
+    /**
+     * Generate SELECT columns with includes as JSONB fields (v3.5)
+     */
+    private generateIncludesCases;
+    /**
+     * Generate all table columns for SELECT clause
+     */
+    private generateTableColumns;
+    /**
+     * Generate SQL computed fields (v3.8)
+     * Returns computed field expressions for SELECT clause
+     */
+    private generateSQLComputedFields;
+    /**
+     * Generate results function signature
+     */
+    generateResultsSignature(): string;
+    /**
+     * Generate complete results function SQL (NEW - replaces filter + .in pattern!)
+     */
+    generateResultsFunction(): string;
+    /**
+     * Generate both results and counts functions (NEW API)
+     */
+    generate(): GeneratedSQL;
+    /**
+     * Write migrations to files (NEW - generates results + counts)
+     */
+    writeMigrations(options?: {
+        force?: boolean;
+        outputDir?: string;
+        legacy?: boolean;
+    }): {
+        resultsFile: string;
+        countsFile: string;
+        filterFile?: string;
+    };
+}
+//# sourceMappingURL=rpc-generator.d.ts.map

package/dist/generators/rpc/rpc-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-generator.d.ts","sourceRoot":"","sources":["../../../src/generators/rpc/rpc-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAgBnF,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CAC9D;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAyB;IAC1C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;gBAEhC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB;IA6BhE;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,YAAY,IAAI,gBAAgB,EAAE;IAUlC;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAoBjC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IA2BjD;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAU9B;;OAEG;IACH,eAAe,IAAI,MAAM;IAiDzB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA4BnB;;OAEG;IACH,sBAAsB,IAAI,MAAM;IA0ChC;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAgCjD;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAW/B;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAkBjC;;OAEG;IACH,sBAAsB,IAAI,MAAM;IA4EhC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA4H5B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;OAEG;IACH,wBAAwB,IAAI,MAAM;IAmBlC;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAyFjC;;OAEG;IACH,QAAQ,IAAI,YAAY;IAQxB;;OAEG;IACH,eAAe,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAyD3J"}