@mantajs/core 0.1.7 → 0.2.0-beta.0

package/dist/testing/relational-query-suite.js

@@ -0,0 +1,233 @@
+// F35 — Shared conformance suite for IRelationalQueryPort.
+//
+// Consumed by:
+//   - `packages/core/tests/conformance/relational-query.test.ts` (InMemory factory)
+//   - `packages/adapter-database-pg/tests/relational-query.conformance.test.ts` (PG factory)
+//
+// The suite seeds a canonical dataset (products, variants, categories, and a
+// product_category pivot) then exercises the port contract with a mix of
+// root filters, dotted relation filters, operators, pagination, sort, and
+// M:N pivot traversal.
+//
+// IMPORTANT: the suite imports `describe`/`it`/etc from vitest. It is only
+// intended to be loaded from test files — do not re-export it from
+// `@mantajs/core` main entry.
+import { beforeEach, describe, expect, it } from 'vitest';
+export function buildDefaultSeed() {
+    return {
+        products: {
+            rows: [
+                { id: 'p1', title: 'Shirt', status: 'active', price: 25, deleted_at: null },
+                { id: 'p2', title: 'Pants', status: 'active', price: 50, deleted_at: null },
+                { id: 'p3', title: 'Deleted Item', status: 'draft', price: 0, deleted_at: '2026-01-01' },
+            ],
+        },
+        variants: {
+            rows: [
+                { id: 'v1', sku: 'SHIRT-S', price: 25, product_id: 'p1', deleted_at: null },
+                { id: 'v2', sku: 'SHIRT-M', price: 30, product_id: 'p1', deleted_at: null },
+                { id: 'v3', sku: 'PANTS-L', price: 50, product_id: 'p2', deleted_at: null },
+                { id: 'v4', sku: 'DELETED-V', price: 0, product_id: 'p1', deleted_at: '2026-01-01' },
+            ],
+        },
+        categories: {
+            rows: [
+                { id: 'c1', name: 'Tops', deleted_at: null },
+                { id: 'c2', name: 'Bottoms', deleted_at: null },
+            ],
+        },
+        product_categories: {
+            rows: [
+                { id: 'pc1', product_id: 'p1', category_id: 'c1' },
+                { id: 'pc2', product_id: 'p2', category_id: 'c2' },
+            ],
+        },
+    };
+}
+// ── Suite runner ────────────────────────────────────────────────────
+export function runRelationalQueryConformance(factory) {
+    describe(`IRelationalQueryPort conformance (${factory.name})`, () => {
+        let rq;
+        let teardown;
+        beforeEach(async () => {
+            const instance = await factory.create();
+            rq = instance.rq;
+            teardown = instance.teardown;
+            await instance.seed(buildDefaultSeed());
+            return async () => {
+                await teardown();
+            };
+        });
+        // RQ-01 — Basic findWithRelations
+        it('RQ-01: findWithRelations with one hasMany relation', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+            });
+            expect(results).toHaveLength(2);
+            const shirt = results.find((r) => r.id === 'p1');
+            expect(shirt).toBeDefined();
+            expect(shirt?.variants).toHaveLength(2); // v4 excluded (soft-deleted)
+        });
+        // RQ-02 — Relation filter (dotted path, equality)
+        it('RQ-02: findWithRelations with relation filter (dotted path, equality)', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                filters: { 'variants.sku': 'SHIRT-S' },
+            });
+            expect(results).toHaveLength(1);
+            expect(results[0].id).toBe('p1');
+        });
+        // RQ-03 — Sort on root entity
+        it('RQ-03: findWithRelations with sort', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*'],
+                sort: { title: 'desc' },
+            });
+            expect(results).toHaveLength(2);
+            expect(results[0].title).toBe('Shirt');
+            expect(results[1].title).toBe('Pants');
+        });
+        // RQ-04 — Soft-delete propagation
+        it('RQ-04: soft-delete filters out deleted records by default', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+            });
+            expect(results).toHaveLength(2); // p3 excluded
+            const shirt = results.find((r) => r.id === 'p1');
+            expect(shirt?.variants).toHaveLength(2); // v4 excluded
+        });
+        // RQ-05 — Pagination + relPagination
+        it('RQ-05: pagination and relation pagination', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                sort: { title: 'asc' }, // deterministic
+                pagination: { limit: 1 },
+                relPagination: { variants: { limit: 1 } },
+            });
+            expect(results).toHaveLength(1);
+            if (results[0].variants) {
+                expect(results[0].variants).toHaveLength(1);
+            }
+        });
+        // RQ-06 — manyToMany via pivot
+        it('RQ-06: manyToMany relation via pivot table', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*', 'categories.*'],
+            });
+            expect(results).toHaveLength(2);
+            const shirt = results.find((r) => r.id === 'p1');
+            expect(shirt?.categories).toHaveLength(1);
+        });
+        // RQ-07 — withDeleted = true
+        it('RQ-07: withDeleted includes soft-deleted records', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                withDeleted: true,
+            });
+            expect(results).toHaveLength(3); // includes p3
+            const shirt = results.find((r) => r.id === 'p1');
+            expect(shirt?.variants).toHaveLength(3); // includes v4
+        });
+        // findAndCountWithRelations — basic
+        it('findAndCountWithRelations returns results + total count', async () => {
+            const [results, count] = await rq.findAndCountWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                pagination: { limit: 1 },
+            });
+            expect(results).toHaveLength(1);
+            expect(count).toBe(2); // total without pagination
+        });
+        // RQ-BC11 — count must respect relation filters
+        it('RQ-BC11: findAndCountWithRelations count respects relation filters', async () => {
+            const [results, count] = await rq.findAndCountWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                filters: { 'variants.sku': 'SHIRT-S' },
+                pagination: { limit: 10 },
+            });
+            expect(count).toBe(1);
+            expect(results).toHaveLength(1);
+            expect(results[0].id).toBe('p1');
+        });
+        // belongsTo — inverse direction
+        it('resolves belongsTo relation', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'variant',
+                fields: ['*', 'product.*'],
+            });
+            expect(results).toHaveLength(3); // v4 excluded
+            const v1 = results.find((r) => r.id === 'v1');
+            expect(v1?.product).toBeTruthy();
+            expect(v1?.product?.title).toBe('Shirt');
+        });
+        // ── F35 additions (RQ-19..RQ-22) ─────────────────────────────────
+        // RQ-19 — Root filter with $in operator
+        it('RQ-19: root filter with $in operator', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*'],
+                filters: { id: { $in: ['p1', 'p2', 'pX'] } },
+                sort: { title: 'asc' },
+            });
+            expect(results).toHaveLength(2);
+            expect(results.map((r) => r.id).sort()).toEqual(['p1', 'p2']);
+        });
+        // RQ-20 — Relation dotted-path filter with $in operator
+        it('RQ-20: relation dotted-path filter with $in operator', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                filters: { 'variants.sku': { $in: ['SHIRT-S', 'PANTS-L'] } },
+                sort: { title: 'asc' },
+            });
+            expect(results).toHaveLength(2);
+            expect(results.map((r) => r.id).sort()).toEqual(['p1', 'p2']);
+        });
+        // RQ-21 — findAndCountWithRelations pagination window with relation filter
+        it('RQ-21: findAndCountWithRelations pagination window with relation filter', async () => {
+            const [results, count] = await rq.findAndCountWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                filters: { 'variants.price': { $gte: 25 } },
+                sort: { title: 'asc' },
+                pagination: { limit: 1, offset: 0 },
+            });
+            // Both p1 (via v1/v2) and p2 (via v3) match $gte 25 on variants.
+            expect(count).toBe(2);
+            expect(results).toHaveLength(1);
+            // First page alphabetically is 'Pants' (p2)
+            expect(results[0].id).toBe('p2');
+            const [page2, count2] = await rq.findAndCountWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                filters: { 'variants.price': { $gte: 25 } },
+                sort: { title: 'asc' },
+                pagination: { limit: 1, offset: 1 },
+            });
+            expect(count2).toBe(2);
+            expect(page2).toHaveLength(1);
+            expect(page2[0].id).toBe('p1');
+        });
+        // RQ-22 — sort + relation filter + pagination together
+        it('RQ-22: sort + relation filter + pagination combined', async () => {
+            const results = await rq.findWithRelations({
+                entity: 'product',
+                fields: ['*', 'variants.*'],
+                filters: { 'variants.price': { $gt: 20 } },
+                sort: { price: 'desc' },
+                pagination: { limit: 2, offset: 0 },
+            });
+            // p2 (price 50) first, then p1 (price 25)
+            expect(results.map((r) => r.id)).toEqual(['p2', 'p1']);
+        });
+    });
+}
+//# sourceMappingURL=relational-query-suite.js.map

package/dist/testing/relational-query-suite.js.map

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

package/dist/user/auto-routes.d.ts

@@ -0,0 +1,32 @@
+import type { AuthModuleService } from '../auth/auth-module-service';
+import type { ICachePort } from '../ports/cache';
+import type { ILoggerPort } from '../ports/logger';
+import type { INotificationPort } from '../ports/notification';
+import type { IRepository } from '../ports/repository';
+import type { UserDefinition } from './define-user';
+export interface RouteEntry {
+    method: 'GET' | 'POST' | 'DELETE';
+    path: string;
+    handler: (req: Request) => Promise<Response>;
+    /** If true, no auth required (login, forgot-password, etc.) */
+    public?: boolean;
+}
+export interface AutoRouteDeps {
+    userDef: UserDefinition;
+    authService: AuthModuleService;
+    userRepo: IRepository;
+    inviteRepo: IRepository;
+    cache: ICachePort;
+    logger: ILoggerPort;
+    jwtSecret: string;
+    notification?: INotificationPort;
+    baseUrl?: string;
+    publicPathPrefix?: string;
+}
+export declare function generateAuthRoutes(deps: AutoRouteDeps): RouteEntry[];
+export declare function generateUserCrudRoutes(deps: AutoRouteDeps): RouteEntry[];
+export declare function generateInviteRoutes(deps: AutoRouteDeps): RouteEntry[];
+export declare function generateAllUserRoutes(deps: AutoRouteDeps): RouteEntry[];
+/** Public route paths for a context (no auth required). */
+export declare function getPublicPaths(ctx: string): string[];
+//# sourceMappingURL=auto-routes.d.ts.map

package/dist/user/auto-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-routes.d.ts","sourceRoot":"","sources":["../../src/user/auto-routes.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC5C,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAA;IACvB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,QAAQ,EAAE,WAAW,CAAA;IACrB,UAAU,EAAE,WAAW,CAAA;IACvB,KAAK,EAAE,UAAU,CAAA;IACjB,MAAM,EAAE,WAAW,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,iBAAiB,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AA6DD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,EAAE,CA2MpE;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,EAAE,CA2GxE;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,EAAE,CAyHtE;AAID,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU,EAAE,CAEvE;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAUpD"}