@rangka/core 0.0.1

package/dist/api/route-generator.js

@@ -0,0 +1,315 @@
+import { KyselyModelOps } from '../db/model-ops.js';
+import { listHandler, getHandler, createHandler, updateHandler, deleteHandler, } from './handlers.js';
+import { createAuthHook, createSessionHandler, deleteSessionHandler } from '../auth/session.js';
+import { createModelPermissionGuard } from '../auth/model-permissions.js';
+import { createScopeHook, createScopeWriteGuard } from '../auth/scopes.js';
+import { createFieldWriteGuard, createFieldStripHook } from '../auth/field-permissions.js';
+import { withHooksCreate, withHooksUpdate, withHooksDelete } from '../hooks/middleware.js';
+import { modelToSchemaComponent, modelToCreateSchema, modelToUpdateSchema, } from './openapi-schema.js';
+import { createMetaBootHandler } from './meta-handler.js';
+// ─── Main entry point ────────────────────────────────────────────────────────
+/**
+ * Registers all REST routes for every model in the schema registry,
+ * plus session and meta routes.
+ */
+export function generateRoutes(server, registry, db, options) {
+    const permissionRegistry = options?.permissionRegistry;
+    const hookRegistry = options?.hookRegistry;
+    const serviceRegistry = options?.serviceRegistry;
+    const eventBus = options?.eventBus;
+    const scopeRegistry = options?.scopeRegistry;
+    const config = options?.config ?? {};
+    registerSessionRoutes(server, db, permissionRegistry);
+    registerMetaRoute(server, db, registry, permissionRegistry, options);
+    for (const [module, models] of registry.getModelsByModule()) {
+        for (const model of models) {
+            // Session model has dedicated routes above; skip it here.
+            if (model.qualifiedName === 'core.session')
+                continue;
+            if (model.source) {
+                registerExternalModelRoutes(server, model, module, {
+                    registry,
+                    db,
+                    permissionRegistry,
+                    hookRegistry,
+                    serviceRegistry,
+                    eventBus,
+                    scopeRegistry,
+                    config,
+                    adapterRegistry: options?.adapterRegistry,
+                    adapterCapabilities: options?.adapterCapabilities,
+                });
+            }
+            else {
+                registerModelRoutes(server, model, module, {
+                    registry,
+                    db,
+                    permissionRegistry,
+                    hookRegistry,
+                    serviceRegistry,
+                    eventBus,
+                    scopeRegistry,
+                    config,
+                });
+            }
+        }
+    }
+}
+// ─── Session routes (login/logout) ───────────────────────────────────────────
+function registerSessionRoutes(server, db, permissionRegistry) {
+    server.post('/api/core/session', createSessionHandler(db));
+    if (permissionRegistry) {
+        server.delete('/api/core/session', {
+            onRequest: createAuthHook(db, permissionRegistry),
+            handler: deleteSessionHandler(db),
+        });
+    }
+}
+// ─── Meta boot route (provides UI shell config) ─────────────────────────────
+function registerMetaRoute(server, db, registry, permissionRegistry, options) {
+    if (!permissionRegistry || !options?.pages || !options?.modules)
+        return;
+    const metaCtx = {
+        schemaRegistry: registry,
+        pages: options.pages,
+        modules: options.modules,
+        widgets: options.widgets,
+    };
+    server.get('/api/meta/boot', {
+        onRequest: createAuthHook(db, permissionRegistry),
+        schema: { tags: ['meta'] },
+        handler: createMetaBootHandler(metaCtx),
+    });
+}
+// ─── Per-model CRUD routes ───────────────────────────────────────────────────
+/** Registers list, get, create, update, delete routes for a model. */
+function registerModelRoutes(server, model, module, ctx) {
+    const basePath = `/api/${module}/${model.name}`;
+    const authHooks = buildAuthHooks(model, ctx);
+    const schemas = buildRouteSchemas(model, module);
+    const modelAccessOpts = { db: ctx.db, registry: ctx.registry };
+    const handlerCtx = { model, registry: ctx.registry, db: ctx.db.kysely, modelAccessOpts };
+    const modelHasHooks = ctx.hookRegistry?.hasHooks(model.qualifiedName) ?? false;
+    const hookMiddlewareCtx = {
+        model,
+        registry: ctx.registry,
+        db: ctx.db.kysely,
+        ops: new KyselyModelOps({ db: ctx.db, model, registry: ctx.registry }),
+        hookRegistry: ctx.hookRegistry,
+        serviceRegistry: ctx.serviceRegistry,
+        eventBus: ctx.eventBus,
+        config: ctx.config,
+    };
+    // Read endpoints
+    server.get(basePath, { ...authHooks, schema: schemas.list, handler: listHandler(handlerCtx) });
+    server.get(`${basePath}/:id`, {
+        ...authHooks,
+        schema: schemas.get,
+        handler: getHandler(handlerCtx),
+    });
+    // Write endpoints (use hook middleware when lifecycle hooks are registered)
+    server.post(basePath, {
+        ...authHooks,
+        schema: schemas.create,
+        handler: modelHasHooks ? withHooksCreate(hookMiddlewareCtx) : createHandler(handlerCtx),
+    });
+    server.put(`${basePath}/:id`, {
+        ...authHooks,
+        schema: schemas.update,
+        handler: modelHasHooks ? withHooksUpdate(hookMiddlewareCtx) : updateHandler(handlerCtx),
+    });
+    server.delete(`${basePath}/:id`, {
+        ...authHooks,
+        schema: schemas.delete,
+        handler: modelHasHooks ? withHooksDelete(hookMiddlewareCtx) : deleteHandler(handlerCtx),
+    });
+}
+// ─── External model routes (capability-gated, no hooks) ────────────────────
+/** Registers routes for an external model, limited by adapter capabilities. */
+function registerExternalModelRoutes(server, model, module, ctx) {
+    const basePath = `/api/${module}/${model.name}`;
+    const authHooks = buildAuthHooks(model, ctx);
+    const schemas = buildRouteSchemas(model, module);
+    const modelAccessOpts = {
+        db: ctx.db,
+        registry: ctx.registry,
+        adapterRegistry: ctx.adapterRegistry,
+        adapterCapabilities: ctx.adapterCapabilities,
+    };
+    const handlerCtx = { model, registry: ctx.registry, db: ctx.db.kysely, modelAccessOpts };
+    const capabilities = new Set(ctx.adapterCapabilities?.[model.source] ?? ['read']);
+    // GET single is always available (read is required for all adapters)
+    server.get(`${basePath}/:id`, {
+        ...authHooks,
+        schema: schemas.get,
+        handler: getHandler(handlerCtx),
+    });
+    // GET list requires 'list' capability
+    if (capabilities.has('list') || capabilities.has('read')) {
+        server.get(basePath, { ...authHooks, schema: schemas.list, handler: listHandler(handlerCtx) });
+    }
+    // POST create requires 'create' capability
+    if (capabilities.has('create')) {
+        server.post(basePath, {
+            ...authHooks,
+            schema: schemas.create,
+            handler: createHandler(handlerCtx),
+        });
+    }
+    // PUT update requires 'update' capability
+    if (capabilities.has('update')) {
+        server.put(`${basePath}/:id`, {
+            ...authHooks,
+            schema: schemas.update,
+            handler: updateHandler(handlerCtx),
+        });
+    }
+    // DELETE requires 'delete' capability
+    if (capabilities.has('delete')) {
+        server.delete(`${basePath}/:id`, {
+            ...authHooks,
+            schema: schemas.delete,
+            handler: deleteHandler(handlerCtx),
+        });
+    }
+}
+// ─── Auth hook assembly ──────────────────────────────────────────────────────
+/** Builds the full set of Fastify auth hooks (onRequest, preHandler, onSend) for a model. */
+function buildAuthHooks(model, ctx) {
+    if (!ctx.permissionRegistry)
+        return {};
+    const { db, permissionRegistry, scopeRegistry } = ctx;
+    const preHandler = [
+        createModelPermissionGuard(model, permissionRegistry),
+    ];
+    if (scopeRegistry) {
+        const scopeCtx = { model, scopeRegistry, db };
+        preHandler.push(createScopeHook(scopeCtx));
+        preHandler.push(createScopeWriteGuard(scopeCtx));
+    }
+    preHandler.push(createFieldWriteGuard(model));
+    return {
+        onRequest: createAuthHook(db, permissionRegistry),
+        preHandler,
+        onSend: createFieldStripHook(model),
+    };
+}
+// ─── Route schema definitions ────────────────────────────────────────────────
+/** Builds Fastify JSON Schema objects for each CRUD operation on a model. */
+function buildRouteSchemas(model, module) {
+    const tag = module;
+    const createBody = modelToCreateSchema(model);
+    const updateBody = modelToUpdateSchema(model);
+    const idParams = {
+        type: 'object',
+        properties: { id: { type: 'string', description: 'Record ID' } },
+        required: ['id'],
+    };
+    const listQuerystring = {
+        type: 'object',
+        properties: {
+            page: { type: 'integer', default: 1, description: 'Page number' },
+            limit: {
+                type: 'integer',
+                default: 25,
+                maximum: 100,
+                description: 'Records per page',
+            },
+            sort: {
+                type: 'string',
+                description: 'Sort fields (prefix with - for descending, comma-separated)',
+            },
+            fields: {
+                type: 'string',
+                description: 'Sparse fieldset (comma-separated field names)',
+            },
+            include: {
+                type: 'string',
+                description: 'Eager-load relations (comma-separated, dot notation for nested)',
+            },
+            includeArchived: {
+                type: 'string',
+                description: 'Include soft-deleted (archived) records (true/false)',
+            },
+            search: {
+                type: 'string',
+                description: 'Search keyword applied across searchable fields',
+            },
+        },
+        additionalProperties: true,
+    };
+    return {
+        list: { tags: [tag], querystring: listQuerystring },
+        get: { tags: [tag], params: idParams },
+        create: { tags: [tag], body: createBody },
+        update: { tags: [tag], params: idParams, body: updateBody },
+        delete: { tags: [tag], params: idParams },
+    };
+}
+// ─── OpenAPI response schemas ────────────────────────────────────────────────
+/** Builds OpenAPI response schemas (200, 201, 400, 404, etc.) for a model's endpoints. */
+export function buildOpenApiResponseSchemas(model) {
+    const responseSchema = modelToSchemaComponent(model);
+    const errorResponse = {
+        type: 'object',
+        properties: {
+            error: {
+                type: 'object',
+                properties: {
+                    code: { type: 'string' },
+                    message: { type: 'string' },
+                },
+            },
+        },
+    };
+    const paginationMeta = {
+        type: 'object',
+        properties: {
+            total: { type: 'integer' },
+            page: { type: 'integer' },
+            limit: { type: 'integer' },
+            totalPages: { type: 'integer' },
+        },
+    };
+    return {
+        list: {
+            200: {
+                description: 'Paginated list',
+                type: 'object',
+                properties: {
+                    data: { type: 'array', items: responseSchema },
+                    meta: paginationMeta,
+                },
+            },
+        },
+        get: {
+            200: {
+                description: 'Single record',
+                type: 'object',
+                properties: { data: responseSchema },
+            },
+            404: errorResponse,
+        },
+        create: {
+            201: {
+                description: 'Created record',
+                type: 'object',
+                properties: { data: responseSchema },
+            },
+            400: errorResponse,
+        },
+        update: {
+            200: {
+                description: 'Updated record',
+                type: 'object',
+                properties: { data: responseSchema },
+            },
+            404: errorResponse,
+        },
+        delete: {
+            204: { description: 'No content', type: 'null' },
+            404: errorResponse,
+        },
+    };
+}
+//# sourceMappingURL=route-generator.js.map

package/dist/api/route-generator.js.map

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

package/dist/api/server.d.ts

@@ -0,0 +1,8 @@
+import type { FastifyInstance } from 'fastify';
+import type { ServerConfig } from './types.js';
+/**
+ * Create and configure the Fastify server instance with JSON parsing,
+ * error handling, and optional OpenAPI docs.
+ */
+export declare function createServer(options?: ServerConfig): Promise<FastifyInstance>;
+//# sourceMappingURL=server.d.ts.map

package/dist/api/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAI7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBnF"}

package/dist/api/server.js

@@ -0,0 +1,128 @@
+import Fastify from 'fastify';
+import fastifySwagger from '@fastify/swagger';
+import fastifySwaggerUi from '@fastify/swagger-ui';
+import qs from 'qs';
+import { AppError } from '../errors.js';
+/**
+ * Create and configure the Fastify server instance with JSON parsing,
+ * error handling, and optional OpenAPI docs.
+ */
+export async function createServer(options) {
+    const server = Fastify({
+        logger: options?.logger ?? { level: 'error' },
+        genReqId: () => crypto.randomUUID(),
+        requestIdHeader: options?.requestIdHeader ?? 'x-request-id',
+        routerOptions: {
+            querystringParser: (str) => qs.parse(str),
+        },
+    });
+    const docsEnabled = options?.docs !== false;
+    if (docsEnabled) {
+        await registerOpenApiDocs(server, options);
+    }
+    registerJsonParser(server);
+    registerErrorHandler(server);
+    return server;
+}
+/** Register @fastify/swagger and swagger-ui for API documentation. */
+async function registerOpenApiDocs(server, options) {
+    await server.register(fastifySwagger, {
+        openapi: {
+            openapi: '3.1.0',
+            info: {
+                title: 'Rangka API',
+                version: '1.0.0',
+            },
+            tags: options?.tags ?? [],
+        },
+    });
+    await server.register(fastifySwaggerUi, {
+        routePrefix: '/api/docs',
+    });
+}
+/** Override the default JSON content-type parser with explicit error handling. */
+function registerJsonParser(server) {
+    server.addContentTypeParser('application/json', { parseAs: 'string' }, (req, body, done) => {
+        try {
+            const str = body.trim();
+            if (!str) {
+                done(null, undefined);
+                return;
+            }
+            const parsed = JSON.parse(str);
+            done(null, parsed);
+        }
+        catch (err) {
+            done(err, undefined);
+        }
+    });
+}
+/** Normalize all errors into a consistent { error: { code, message, details? } } shape. */
+function registerErrorHandler(server) {
+    server.setErrorHandler((error, request, reply) => {
+        if (error instanceof AppError) {
+            if (error.statusCode >= 500) {
+                request.log.error({ err: error, url: request.url }, 'AppError %s: %s', error.code, error.message);
+            }
+            const response = {
+                error: {
+                    code: error.code,
+                    message: error.message,
+                    ...(error.details !== undefined && { details: error.details }),
+                },
+            };
+            return reply.status(error.statusCode).send(response);
+        }
+        // Handle Postgres/database errors with meaningful messages
+        const pgCode = error.code;
+        if (typeof pgCode === 'string' && pgCode.match(/^[0-9A-Z]{5}$/)) {
+            const detail = mapPgError(pgCode, error.message);
+            request.log.error({ err: error, url: request.url, pgCode }, 'Database error: %s', detail);
+            return reply.status(500).send({
+                error: { code: 'INTERNAL_ERROR', message: 'An internal error occurred' },
+            });
+        }
+        const statusCode = error.statusCode ?? 500;
+        if (statusCode >= 500) {
+            request.log.error({ err: error, url: request.url }, 'Unhandled error: %s', error.message);
+        }
+        const response = {
+            error: {
+                code: error.code ?? 'INTERNAL_ERROR',
+                message: statusCode >= 500 ? 'An internal error occurred' : error.message,
+                ...(error.validation && { details: error.validation }),
+            },
+        };
+        reply.status(statusCode).send(response);
+    });
+}
+function mapPgError(code, raw) {
+    switch (code) {
+        case '42P01':
+            return `Table does not exist: ${extractRelation(raw)}`;
+        case '42703':
+            return `Column does not exist: ${extractDetail(raw)}`;
+        case '23505':
+            return `Duplicate value violates unique constraint`;
+        case '23503':
+            return `Referenced record does not exist (foreign key violation)`;
+        case '23502':
+            return `Missing required field (not-null violation)`;
+        case '42P02':
+            return `Invalid query parameter`;
+        case '08001':
+        case '08006':
+            return `Database connection failed`;
+        default:
+            return `Database error (${code})`;
+    }
+}
+function extractRelation(msg) {
+    const match = msg.match(/relation "([^"]+)"/);
+    return match ? match[1] : 'unknown';
+}
+function extractDetail(msg) {
+    const match = msg.match(/column "([^"]+)"/);
+    return match ? match[1] : 'unknown';
+}
+//# sourceMappingURL=server.js.map

package/dist/api/server.js.map

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

package/dist/api/types.d.ts

@@ -0,0 +1,20 @@
+export interface ServerConfig {
+    port?: number;
+    host?: string;
+    logger?: boolean | {
+        level: string;
+    };
+    requestIdHeader?: string;
+    docs?: boolean;
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+export interface ApiDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    roles?: string[];
+    handler: (request: any, reply: any) => Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjB,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzD"}

package/dist/api/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":""}

package/dist/audit/__tests__/audit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit.test.d.ts.map

package/dist/audit/__tests__/audit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.test.d.ts","sourceRoot":"","sources":["../../../src/audit/__tests__/audit.test.ts"],"names":[],"mappings":""}

package/dist/audit/__tests__/audit.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { recordAudit, getAuditHistory } from '../record.js';
+function createMockDb() {
+    const rows = [];
+    let idCounter = 1;
+    const db = {
+        insertInto: (_table) => ({
+            values: (data) => ({
+                returningAll: () => ({
+                    execute: async () => {
+                        const row = {
+                            id: `audit-${idCounter++}`,
+                            ...data,
+                            changes: typeof data.changes === 'string' ? JSON.parse(data.changes) : data.changes,
+                            timestamp: new Date(),
+                        };
+                        rows.push(row);
+                        return [row];
+                    },
+                }),
+            }),
+        }),
+        selectFrom: (_table) => {
+            const filters = [];
+            const builder = {
+                selectAll: () => builder,
+                where: (col, op, val) => {
+                    filters.push({ col, val });
+                    return builder;
+                },
+                orderBy: () => builder,
+                execute: async () => {
+                    return rows.filter((r) => filters.every((f) => r[f.col] === f.val));
+                },
+            };
+            return builder;
+        },
+    };
+    return { db, rows };
+}
+describe('Audit Log', () => {
+    let db;
+    beforeEach(() => {
+        const mock = createMockDb();
+        db = mock.db;
+    });
+    it('records audit on create with all fields as changes', async () => {
+        const result = await recordAudit(db, {
+            model: 'sales.invoice',
+            documentId: 'inv-1',
+            action: 'create',
+            userId: 'user-1',
+            before: null,
+            after: { name: 'INV-001', amount: 1000 },
+        });
+        expect(result).not.toBeNull();
+        expect(result.action).toBe('create');
+        expect(result.changes.name).toEqual({ from: null, to: 'INV-001' });
+        expect(result.changes.amount).toEqual({ from: null, to: 1000 });
+    });
+    it('records audit on update with only changed fields', async () => {
+        const result = await recordAudit(db, {
+            model: 'sales.invoice',
+            documentId: 'inv-1',
+            action: 'update',
+            userId: 'user-1',
+            before: { name: 'INV-001', amount: 1000, status: 'draft' },
+            after: { name: 'INV-001', amount: 2000, status: 'draft' },
+        });
+        expect(result).not.toBeNull();
+        expect(result.changes.amount).toEqual({ from: 1000, to: 2000 });
+        expect(result.changes.name).toBeUndefined();
+    });
+    it('returns null for update with no actual changes', async () => {
+        const result = await recordAudit(db, {
+            model: 'sales.invoice',
+            documentId: 'inv-1',
+            action: 'update',
+            userId: 'user-1',
+            before: { name: 'INV-001', amount: 1000 },
+            after: { name: 'INV-001', amount: 1000 },
+        });
+        expect(result).toBeNull();
+    });
+    it('records audit on delete with all fields removed', async () => {
+        const result = await recordAudit(db, {
+            model: 'sales.invoice',
+            documentId: 'inv-1',
+            action: 'delete',
+            userId: 'user-1',
+            before: { name: 'INV-001', amount: 1000 },
+            after: null,
+        });
+        expect(result).not.toBeNull();
+        expect(result.changes.name).toEqual({ from: 'INV-001', to: null });
+    });
+    it('ignores internal timestamp fields in diff', async () => {
+        const result = await recordAudit(db, {
+            model: 'sales.invoice',
+            documentId: 'inv-1',
+            action: 'update',
+            userId: 'user-1',
+            before: { name: 'INV-001', updated_at: '2024-01-01' },
+            after: { name: 'INV-001', updated_at: '2024-01-02' },
+        });
+        expect(result).toBeNull();
+    });
+    it('retrieves audit history for a document', async () => {
+        await recordAudit(db, {
+            model: 'sales.invoice',
+            documentId: 'inv-1',
+            action: 'create',
+            before: null,
+            after: { name: 'INV-001' },
+        });
+        await recordAudit(db, {
+            model: 'sales.invoice',
+            documentId: 'inv-1',
+            action: 'submit',
+            before: { status: 'draft' },
+            after: { status: 'submitted' },
+        });
+        const history = await getAuditHistory(db, 'sales.invoice', 'inv-1');
+        expect(history).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=audit.test.js.map

package/dist/audit/__tests__/audit.test.js.map

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