@archlast/server 0.0.1

package/dist/controllers/tenant.controller.d.ts

@@ -0,0 +1,316 @@
+/**
+ * Tenant Controller (Elysia Plugin)
+ * Handles all /_auth/tenants/* endpoints
+ *
+ * Business logic has been extracted to TenantService.
+ * This controller handles HTTP concerns only.
+ */
+import { Elysia } from "elysia";
+export declare const tenantController: Elysia<"/tenants", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+} & {
+    schema: {};
+    standaloneSchema: {};
+    macro: Partial<{}>;
+    macroFn: ({ onBeforeHandle }: any) => {
+        requireAuth(enabled: boolean): void;
+    };
+    parser: {};
+    response: {};
+}, {
+    tenants: {};
+} & {
+    tenants: {
+        get: {
+            body: unknown;
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: {
+                    error: string;
+                    tenants?: undefined;
+                } | {
+                    tenants: import("../services/tenant.service.js").TenantInfo[];
+                    error?: undefined;
+                };
+            };
+        };
+    };
+} & {
+    tenants: {
+        post: {
+            body: {
+                name: string;
+            };
+            params: {};
+            query: unknown;
+            headers: unknown;
+            response: {
+                200: import("../services/tenant.service.js").CreateTenantResult | {
+                    error: string;
+                };
+                422: {
+                    type: "validation";
+                    on: string;
+                    summary?: string;
+                    message?: string;
+                    found?: unknown;
+                    property?: string;
+                    expected?: string;
+                };
+            };
+        };
+    };
+} & {
+    tenants: {
+        ":id": {
+            get: {
+                body: unknown;
+                params: {
+                    id: string;
+                };
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: {
+                        error: string;
+                        tenant?: undefined;
+                    } | {
+                        tenant: import("../services/tenant.service.js").TenantDetails | null;
+                        error?: undefined;
+                    };
+                    422: {
+                        type: "validation";
+                        on: string;
+                        summary?: string;
+                        message?: string;
+                        found?: unknown;
+                        property?: string;
+                        expected?: string;
+                    };
+                };
+            };
+        };
+    };
+} & {
+    tenants: {
+        ":id": {
+            patch: {
+                body: {
+                    name?: string | undefined;
+                };
+                params: {
+                    id: string;
+                };
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: import("../services/tenant.service.js").UpdateTenantResult | {
+                        error: string;
+                    };
+                    422: {
+                        type: "validation";
+                        on: string;
+                        summary?: string;
+                        message?: string;
+                        found?: unknown;
+                        property?: string;
+                        expected?: string;
+                    };
+                };
+            };
+        };
+    };
+} & {
+    tenants: {
+        ":id": {
+            delete: {
+                body: unknown;
+                params: {
+                    id: string;
+                };
+                query: unknown;
+                headers: unknown;
+                response: {
+                    200: {
+                        error: string;
+                        success?: undefined;
+                    } | {
+                        success: boolean;
+                        error?: undefined;
+                    };
+                    422: {
+                        type: "validation";
+                        on: string;
+                        summary?: string;
+                        message?: string;
+                        found?: unknown;
+                        property?: string;
+                        expected?: string;
+                    };
+                };
+            };
+        };
+    };
+} & {
+    tenants: {
+        ":id": {
+            members: {
+                get: {
+                    body: unknown;
+                    params: {
+                        id: string;
+                    };
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            error: string;
+                            members?: undefined;
+                        } | {
+                            members: import("../services/tenant.service.js").MemberInfo[];
+                            error?: undefined;
+                        };
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    tenants: {
+        ":id": {
+            members: {
+                ":userId": {
+                    delete: {
+                        body: unknown;
+                        params: {
+                            id: string;
+                            userId: string;
+                        };
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: {
+                                error: string;
+                                success?: undefined;
+                            } | {
+                                success: boolean;
+                                error?: undefined;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    tenants: {
+        ":id": {
+            members: {
+                ":userId": {
+                    patch: {
+                        body: {
+                            role?: string | undefined;
+                            permissions?: string[] | undefined;
+                        };
+                        params: {
+                            id: string;
+                            userId: string;
+                        };
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: {
+                                error: string;
+                                membership?: undefined;
+                            } | {
+                                membership: import("../services/tenant.service.js").MemberInfo;
+                                error?: undefined;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+} & {
+    derive: {
+        readonly auth: null;
+        readonly user: null;
+    } | {
+        readonly auth: import("../auth/interfaces.js").AuthContext;
+        readonly user: {
+            id: string;
+            tenantId: string | null;
+            session: import("../auth/interfaces.js").AuthSession | null;
+        } | null;
+    };
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: import("elysia").ExtractErrorFromHandle<{
+        readonly auth: null;
+        readonly user: null;
+    } | {
+        readonly auth: import("../auth/interfaces.js").AuthContext;
+        readonly user: {
+            id: string;
+            tenantId: string | null;
+            session: import("../auth/interfaces.js").AuthSession | null;
+        } | null;
+    }>;
+}>;
+//# sourceMappingURL=tenant.controller.d.ts.map

package/dist/controllers/tenant.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/tenant.controller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAK,MAAM,QAAQ,CAAC;AAsBnC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+RxB,CAAC"}

package/dist/controllers/tenant.controller.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * Tenant Controller (Elysia Plugin)
+ * Handles all /_auth/tenants/* endpoints
+ *
+ * Business logic has been extracted to TenantService.
+ * This controller handles HTTP concerns only.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tenantController = void 0;
+const elysia_1 = require("elysia");
+const tenant_service_js_1 = require("../services/tenant.service.js");
+const auth_js_1 = require("../http/plugins/auth.js");
+const context_helper_js_1 = require("../http/context-helper.js");
+// Input validation schemas
+const CreateTenantSchema = elysia_1.t.Object({
+    name: elysia_1.t.String({ minLength: 1, maxLength: 100 }),
+});
+const UpdateTenantSchema = elysia_1.t.Object({
+    name: elysia_1.t.Optional(elysia_1.t.String({ minLength: 1, maxLength: 100 })),
+});
+const UpdateMemberSchema = elysia_1.t.Object({
+    role: elysia_1.t.Optional(elysia_1.t.String()),
+    permissions: elysia_1.t.Optional(elysia_1.t.Array(elysia_1.t.String())),
+});
+// Create singleton service instance
+const tenantService = (0, tenant_service_js_1.createTenantService)();
+exports.tenantController = new elysia_1.Elysia({ prefix: "/tenants", tags: ["Tenants"] })
+    .use(auth_js_1.authPlugin)
+    /**
+     * GET /_auth/tenants
+     * List all tenants the current user is a member of
+     */
+    .get("/", async (ctx) => {
+    const { db, user, set } = (0, context_helper_js_1.getCtx)(ctx);
+    if (!user) {
+        set.status = 401;
+        return { error: "Unauthorized" };
+    }
+    try {
+        const tenants = await tenantService.listTenants({ userId: user.id, db });
+        return { tenants };
+    }
+    catch (error) {
+        if (error instanceof tenant_service_js_1.TenantError) {
+            set.status = error.statusCode;
+            return { error: error.message };
+        }
+        throw error;
+    }
+}, {
+    detail: {
+        summary: "List user's tenants",
+        description: "Returns all tenants the current user is a member of",
+    },
+})
+    /**
+     * POST /_auth/tenants
+     * Create a new tenant
+     */
+    .post("/", async (ctx) => {
+    const { db, user, logger, body, set } = (0, context_helper_js_1.getCtx)(ctx);
+    if (!user) {
+        set.status = 401;
+        return { error: "Unauthorized" };
+    }
+    try {
+        const result = await tenantService.createTenant({
+            name: body.name,
+            userId: user.id,
+            db,
+            logger,
+        });
+        set.status = 201;
+        return result;
+    }
+    catch (error) {
+        if (error instanceof tenant_service_js_1.TenantError) {
+            set.status = error.statusCode;
+            return { error: error.message };
+        }
+        throw error;
+    }
+}, {
+    body: CreateTenantSchema,
+    detail: { summary: "Create tenant", description: "Creates a new workspace/tenant" },
+})
+    /**
+     * GET /_auth/tenants/:id
+     * Get tenant details
+     */
+    .get("/:id", async (ctx) => {
+    const { db, user, params, set } = (0, context_helper_js_1.getCtx)(ctx);
+    if (!user) {
+        set.status = 401;
+        return { error: "Unauthorized" };
+    }
+    try {
+        const tenant = await tenantService.getTenant({
+            tenantId: params.id,
+            userId: user.id,
+            db,
+        });
+        return { tenant };
+    }
+    catch (error) {
+        if (error instanceof tenant_service_js_1.TenantError) {
+            set.status = error.statusCode;
+            return { error: error.message };
+        }
+        throw error;
+    }
+}, {
+    params: elysia_1.t.Object({ id: elysia_1.t.String() }),
+    detail: { summary: "Get tenant details" },
+})
+    /**
+     * PATCH /_auth/tenants/:id
+     * Update tenant details
+     */
+    .patch("/:id", async (ctx) => {
+    const { db, user, params, body, set } = (0, context_helper_js_1.getCtx)(ctx);
+    if (!user) {
+        set.status = 401;
+        return { error: "Unauthorized" };
+    }
+    try {
+        const result = await tenantService.updateTenant({
+            tenantId: params.id,
+            name: body.name,
+            userId: user.id,
+            db,
+        });
+        return result;
+    }
+    catch (error) {
+        if (error instanceof tenant_service_js_1.TenantError) {
+            set.status = error.statusCode;
+            return { error: error.message };
+        }
+        throw error;
+    }
+}, {
+    params: elysia_1.t.Object({ id: elysia_1.t.String() }),
+    body: UpdateTenantSchema,
+    detail: { summary: "Update tenant" },
+})
+    /**
+     * DELETE /_auth/tenants/:id
+     * Delete tenant (owner only)
+     */
+    .delete("/:id", async (ctx) => {
+    const { db, user, params, set } = (0, context_helper_js_1.getCtx)(ctx);
+    if (!user) {
+        set.status = 401;
+        return { error: "Unauthorized" };
+    }
+    try {
+        await tenantService.deleteTenant({
+            tenantId: params.id,
+            userId: user.id,
+            db,
+        });
+        return { success: true };
+    }
+    catch (error) {
+        if (error instanceof tenant_service_js_1.TenantError) {
+            set.status = error.statusCode;
+            return { error: error.message };
+        }
+        throw error;
+    }
+}, {
+    params: elysia_1.t.Object({ id: elysia_1.t.String() }),
+    detail: { summary: "Delete tenant" },
+})
+    /**
+     * GET /_auth/tenants/:id/members
+     * List members of a tenant
+     */
+    .get("/:id/members", async (ctx) => {
+    const { db, user, params, set } = (0, context_helper_js_1.getCtx)(ctx);
+    if (!user) {
+        set.status = 401;
+        return { error: "Unauthorized" };
+    }
+    try {
+        const members = await tenantService.listMembers({
+            tenantId: params.id,
+            userId: user.id,
+            db,
+        });
+        return { members };
+    }
+    catch (error) {
+        if (error instanceof tenant_service_js_1.TenantError) {
+            set.status = error.statusCode;
+            return { error: error.message };
+        }
+        throw error;
+    }
+}, {
+    params: elysia_1.t.Object({ id: elysia_1.t.String() }),
+    detail: { summary: "List tenant members" },
+})
+    /**
+     * DELETE /_auth/tenants/:id/members/:userId
+     * Remove a member from tenant
+     */
+    .delete("/:id/members/:userId", async (ctx) => {
+    const { db, user, params, set } = (0, context_helper_js_1.getCtx)(ctx);
+    if (!user) {
+        set.status = 401;
+        return { error: "Unauthorized" };
+    }
+    try {
+        await tenantService.removeMember({
+            tenantId: params.id,
+            targetUserId: params.userId,
+            requesterUserId: user.id,
+            db,
+        });
+        return { success: true };
+    }
+    catch (error) {
+        if (error instanceof tenant_service_js_1.TenantError) {
+            set.status = error.statusCode;
+            return { error: error.message };
+        }
+        throw error;
+    }
+}, {
+    params: elysia_1.t.Object({ id: elysia_1.t.String(), userId: elysia_1.t.String() }),
+    detail: { summary: "Remove member from tenant" },
+})
+    /**
+     * PATCH /_auth/tenants/:id/members/:userId
+     * Update member role/permissions
+     */
+    .patch("/:id/members/:userId", async (ctx) => {
+    const { db, user, params, body, set } = (0, context_helper_js_1.getCtx)(ctx);
+    if (!user) {
+        set.status = 401;
+        return { error: "Unauthorized" };
+    }
+    try {
+        const membership = await tenantService.updateMemberRole({
+            tenantId: params.id,
+            targetUserId: params.userId,
+            requesterUserId: user.id,
+            role: body.role,
+            permissions: body.permissions,
+            db,
+        });
+        return { membership };
+    }
+    catch (error) {
+        if (error instanceof tenant_service_js_1.TenantError) {
+            set.status = error.statusCode;
+            return { error: error.message };
+        }
+        throw error;
+    }
+}, {
+    params: elysia_1.t.Object({ id: elysia_1.t.String(), userId: elysia_1.t.String() }),
+    body: UpdateMemberSchema,
+    detail: { summary: "Update member role/permissions" },
+});
+//# sourceMappingURL=tenant.controller.js.map

package/dist/controllers/tenant.controller.js.map

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

package/dist/db/cachedclient.d.ts

@@ -0,0 +1,69 @@
+import { QueryBuilder, QuerySpec, CountSpec, AggregateSpec } from "../query/builder.js";
+import type { RelationsMap, IDatabaseClient, Document } from "./interfaces.js";
+import type { AggregateResult } from "../query/types.js";
+export type { Document, IDatabaseClient } from "./interfaces.js";
+/**
+ * CachedDatabaseClient - Decorator for adding multi-layer caching to any IDatabaseClient.
+ *
+ * This client wraps another IDatabaseClient (e.g., SocketDatabaseClient) and adds:
+ * - Document cache: Single document lookups
+ * - Query cache: Query results (findMany, list, etc.)
+ * - Aggregate cache: Count/sum/avg operations
+ *
+ * Cache invalidation is automatic on mutations.
+ */
+export declare class CachedDatabaseClient<DataModel extends Record<string, Document> = any, Relations extends RelationsMap<DataModel> = RelationsMap<DataModel>> implements IDatabaseClient<DataModel, Relations> {
+    private inner;
+    private documentCache;
+    private queryCache;
+    private aggregateCache;
+    private disabledCollections;
+    cachingEnabled: boolean;
+    private cacheClient;
+    constructor(inner: IDatabaseClient<DataModel, Relations>, cacheClientOrOptions?: any);
+    private trackRead;
+    private shouldBypassCache;
+    applySchema(schema: any): Promise<void>;
+    get<TableName extends keyof DataModel>(collection: TableName, id: string): Promise<DataModel[TableName] | null>;
+    list<TableName extends keyof DataModel>(collection: TableName): Promise<DataModel[TableName][]>;
+    insert<TableName extends keyof DataModel>(collection: TableName, data: Omit<DataModel[TableName], "_id" | "_collection">): Promise<string>;
+    patch<TableName extends keyof DataModel>(collection: TableName, id: string, data: Partial<Omit<DataModel[TableName], "_id" | "_collection">>): Promise<void>;
+    delete<TableName extends keyof DataModel>(collection: TableName, id: string): Promise<void>;
+    query<TableName extends keyof DataModel>(collection: TableName): QueryBuilder<DataModel[TableName]>;
+    executeQuery<T>(spec: QuerySpec): Promise<T[]>;
+    executeCount(spec: CountSpec): Promise<number>;
+    executeAggregate<T>(spec: AggregateSpec): Promise<AggregateResult<T>>;
+    findMany<TableName extends keyof DataModel>(collection: TableName, options?: {
+        where?: any;
+        orderBy?: any;
+        take?: number;
+        skip?: number;
+    }): Promise<DataModel[TableName][]>;
+    findFirst<TableName extends keyof DataModel>(collection: TableName, options?: {
+        where?: any;
+        orderBy?: any;
+    }): Promise<DataModel[TableName] | null>;
+    findUnique<TableName extends keyof DataModel>(collection: TableName, where: any): Promise<DataModel[TableName] | null>;
+    count<TableName extends keyof DataModel>(collection: TableName, where?: any): Promise<number>;
+    update<TableName extends keyof DataModel>(collection: TableName, id: string, data: Partial<Omit<DataModel[TableName], "_id" | "_collection">>): Promise<void>;
+    updateMany<TableName extends keyof DataModel>(collection: TableName, where: any, data: Partial<Omit<DataModel[TableName], "_id" | "_collection">>): Promise<number>;
+    insertMany<TableName extends keyof DataModel>(collection: TableName, data: Omit<DataModel[TableName], "_id" | "_collection">[]): Promise<string[]>;
+    deleteMany<TableName extends keyof DataModel>(collection: TableName, where: any): Promise<number>;
+    runInTransaction<T>(fn: (db: IDatabaseClient<DataModel, Relations>) => Promise<T>): Promise<T>;
+    private invalidateCollection;
+    clearCache(): void;
+    getCacheStats(): Promise<{
+        query: any;
+        document: any;
+        aggregate: any;
+        function: any;
+    } | {
+        document: import("../cache/strategies.js").CacheStats;
+        query: any;
+        aggregate: import("../cache/strategies.js").CacheStats;
+        function?: undefined;
+    }>;
+    loadRelation<TableName extends keyof DataModel, RelationName extends keyof Relations[TableName] & string>(tableName: TableName, record: DataModel[TableName], relationName: RelationName): Promise<Relations[TableName][RelationName]>;
+    loadRelations<TableName extends keyof DataModel, RelationName extends keyof Relations[TableName] & string>(tableName: TableName, records: DataModel[TableName][], relationName: RelationName): Promise<Map<string, Relations[TableName][RelationName]>>;
+}
+//# sourceMappingURL=cachedclient.d.ts.map

package/dist/db/cachedclient.d.ts.map

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