@porulle/core 0.1.0

package/dist/modules/media/module.d.ts

@@ -0,0 +1,292 @@
+import { MediaService } from "./service.js";
+export declare const mediaModule: import("../../kernel/module/define.js").AppModule<{
+    mediaAssets: import("drizzle-orm/pg-core").PgTableWithColumns<{
+        name: "media_assets";
+        schema: undefined;
+        columns: {
+            id: import("drizzle-orm/pg-core").PgColumn<{
+                name: "id";
+                tableName: "media_assets";
+                dataType: "string";
+                columnType: "PgUUID";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: true;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            organizationId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "organization_id";
+                tableName: "media_assets";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            storageKey: import("drizzle-orm/pg-core").PgColumn<{
+                name: "storage_key";
+                tableName: "media_assets";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            filename: import("drizzle-orm/pg-core").PgColumn<{
+                name: "filename";
+                tableName: "media_assets";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            contentType: import("drizzle-orm/pg-core").PgColumn<{
+                name: "content_type";
+                tableName: "media_assets";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            size: import("drizzle-orm/pg-core").PgColumn<{
+                name: "size";
+                tableName: "media_assets";
+                dataType: "number";
+                columnType: "PgInteger";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            width: import("drizzle-orm/pg-core").PgColumn<{
+                name: "width";
+                tableName: "media_assets";
+                dataType: "number";
+                columnType: "PgInteger";
+                data: number;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            height: import("drizzle-orm/pg-core").PgColumn<{
+                name: "height";
+                tableName: "media_assets";
+                dataType: "number";
+                columnType: "PgInteger";
+                data: number;
+                driverParam: string | number;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            alt: import("drizzle-orm/pg-core").PgColumn<{
+                name: "alt";
+                tableName: "media_assets";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            metadata: import("drizzle-orm/pg-core").PgColumn<{
+                name: "metadata";
+                tableName: "media_assets";
+                dataType: "json";
+                columnType: "PgJsonb";
+                data: Record<string, unknown>;
+                driverParam: unknown;
+                notNull: false;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {
+                $type: Record<string, unknown>;
+            }>;
+            uploadedAt: import("drizzle-orm/pg-core").PgColumn<{
+                name: "uploaded_at";
+                tableName: "media_assets";
+                dataType: "date";
+                columnType: "PgTimestamp";
+                data: Date;
+                driverParam: string;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+        };
+        dialect: "pg";
+    }>;
+    entityMedia: import("drizzle-orm/pg-core").PgTableWithColumns<{
+        name: "entity_media";
+        schema: undefined;
+        columns: {
+            entityId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "entity_id";
+                tableName: "entity_media";
+                dataType: "string";
+                columnType: "PgUUID";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            variantId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "variant_id";
+                tableName: "entity_media";
+                dataType: "string";
+                columnType: "PgUUID";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            mediaAssetId: import("drizzle-orm/pg-core").PgColumn<{
+                name: "media_asset_id";
+                tableName: "entity_media";
+                dataType: "string";
+                columnType: "PgUUID";
+                data: string;
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            role: import("drizzle-orm/pg-core").PgColumn<{
+                name: "role";
+                tableName: "entity_media";
+                dataType: "string";
+                columnType: "PgText";
+                data: "primary" | "gallery" | "thumbnail" | "video" | "document";
+                driverParam: string;
+                notNull: true;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: ["primary", "gallery", "thumbnail", "video", "document"];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            sortOrder: import("drizzle-orm/pg-core").PgColumn<{
+                name: "sort_order";
+                tableName: "entity_media";
+                dataType: "number";
+                columnType: "PgInteger";
+                data: number;
+                driverParam: string | number;
+                notNull: true;
+                hasDefault: true;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: undefined;
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+        };
+        dialect: "pg";
+    }>;
+}, MediaService, Record<string, unknown>>;
+//# sourceMappingURL=module.d.ts.map

package/dist/modules/media/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/modules/media/module.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCAgBtB,CAAC"}

package/dist/modules/media/module.js

@@ -0,0 +1,22 @@
+import { defineModule } from "../../kernel/module/index.js";
+import { CatalogRepository } from "../catalog/repository/index.js";
+import { MediaRepository } from "./repository/index.js";
+import { MediaService } from "./service.js";
+import { entityMedia, mediaAssets } from "./schema.js";
+export const mediaModule = defineModule({
+    id: "media",
+    schema: () => ({ mediaAssets, entityMedia }),
+    service: (deps) => {
+        const db = deps.db.db;
+        const storage = deps.config.storage;
+        if (storage == null) {
+            throw new Error("Media module requires config.storage");
+        }
+        return new MediaService({
+            repository: new MediaRepository(db),
+            catalogRepository: new CatalogRepository(db),
+            storage,
+            config: deps.config,
+        });
+    },
+});

package/dist/modules/media/repository/index.d.ts

@@ -0,0 +1,35 @@
+import type { TxContext } from "../../../kernel/database/tx-context.js";
+import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db.js";
+import { mediaAssets, entityMedia } from "../schema.js";
+export type MediaAsset = typeof mediaAssets.$inferSelect;
+export type MediaAssetInsert = typeof mediaAssets.$inferInsert;
+export type EntityMedia = typeof entityMedia.$inferSelect;
+export type EntityMediaInsert = typeof entityMedia.$inferInsert;
+/**
+ * MediaRepository provides type-safe database operations for media assets.
+ *
+ * This repository manages media assets and their associations with entities.
+ * All methods support an optional TxContext parameter for transaction participation.
+ */
+export declare class MediaRepository {
+    private readonly db;
+    constructor(db: DrizzleDatabase);
+    private getDb;
+    findAssetById(id: string, ctx?: TxContext, orgId?: string): Promise<MediaAsset | undefined>;
+    findAssetByStorageKey(storageKey: string, ctx?: TxContext): Promise<MediaAsset | undefined>;
+    findAssetsByIds(ids: string[], ctx?: TxContext): Promise<MediaAsset[]>;
+    createAsset(data: MediaAssetInsert, ctx?: TxContext): Promise<MediaAsset>;
+    updateAsset(id: string, data: Partial<Omit<MediaAssetInsert, "id">>, ctx?: TxContext): Promise<MediaAsset | undefined>;
+    deleteAsset(id: string, ctx?: TxContext): Promise<boolean>;
+    findEntityMedia(entityId: string, variantId?: string, ctx?: TxContext): Promise<EntityMedia[]>;
+    findEntityMediaByRole(entityId: string, role: EntityMedia["role"], variantId?: string, ctx?: TxContext): Promise<EntityMedia[]>;
+    findPrimaryMedia(entityId: string, variantId?: string, ctx?: TxContext): Promise<EntityMedia | undefined>;
+    createEntityMedia(data: EntityMediaInsert, ctx?: TxContext): Promise<EntityMedia>;
+    createEntityMediaBatch(data: EntityMediaInsert[], ctx?: TxContext): Promise<EntityMedia[]>;
+    updateEntityMediaSortOrder(entityId: string, mediaAssetId: string, sortOrder: number, variantId?: string, ctx?: TxContext): Promise<EntityMedia | undefined>;
+    removeEntityMedia(entityId: string, mediaAssetId: string, variantId?: string, ctx?: TxContext): Promise<boolean>;
+    removeAllEntityMedia(entityId: string, ctx?: TxContext): Promise<void>;
+    removeAllMediaByAssetId(mediaAssetId: string, ctx?: TxContext): Promise<void>;
+    findAssetsForEntity(entityId: string, variantId?: string, ctx?: TxContext): Promise<MediaAsset[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/media/repository/index.d.ts.map

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

package/dist/modules/media/repository/index.js

@@ -0,0 +1,176 @@
+import { eq, and, inArray } from "drizzle-orm";
+import { mediaAssets, entityMedia } from "../schema.js";
+/**
+ * MediaRepository provides type-safe database operations for media assets.
+ *
+ * This repository manages media assets and their associations with entities.
+ * All methods support an optional TxContext parameter for transaction participation.
+ */
+export class MediaRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getDb(ctx) {
+        return ctx?.tx ?? this.db;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Media Assets
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findAssetById(id, ctx, orgId) {
+        const db = this.getDb(ctx);
+        const conditions = [eq(mediaAssets.id, id)];
+        if (orgId) {
+            conditions.push(eq(mediaAssets.organizationId, orgId));
+        }
+        const rows = await db
+            .select()
+            .from(mediaAssets)
+            .where(and(...conditions));
+        return rows[0];
+    }
+    async findAssetByStorageKey(storageKey, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .select()
+            .from(mediaAssets)
+            .where(eq(mediaAssets.storageKey, storageKey));
+        return rows[0];
+    }
+    async findAssetsByIds(ids, ctx) {
+        if (ids.length === 0)
+            return [];
+        const db = this.getDb(ctx);
+        return db.select().from(mediaAssets).where(inArray(mediaAssets.id, ids));
+    }
+    async createAsset(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(mediaAssets).values(data).returning();
+        return rows[0];
+    }
+    async updateAsset(id, data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .update(mediaAssets)
+            .set(data)
+            .where(eq(mediaAssets.id, id))
+            .returning();
+        return rows[0];
+    }
+    async deleteAsset(id, ctx) {
+        const db = this.getDb(ctx);
+        const result = await db
+            .delete(mediaAssets)
+            .where(eq(mediaAssets.id, id))
+            .returning();
+        return result.length > 0;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Entity Media (Associations)
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findEntityMedia(entityId, variantId, ctx) {
+        const db = this.getDb(ctx);
+        if (variantId === undefined) {
+            // Find media for entity only (not variant-specific)
+            const rows = await db
+                .select()
+                .from(entityMedia)
+                .where(eq(entityMedia.entityId, entityId));
+            return rows.filter((r) => r.variantId === null);
+        }
+        return db
+            .select()
+            .from(entityMedia)
+            .where(and(eq(entityMedia.entityId, entityId), eq(entityMedia.variantId, variantId)));
+    }
+    async findEntityMediaByRole(entityId, role, variantId, ctx) {
+        const db = this.getDb(ctx);
+        const conditions = [
+            eq(entityMedia.entityId, entityId),
+            eq(entityMedia.role, role),
+        ];
+        if (variantId !== undefined) {
+            conditions.push(eq(entityMedia.variantId, variantId));
+        }
+        const rows = await db
+            .select()
+            .from(entityMedia)
+            .where(and(...conditions));
+        if (variantId === undefined) {
+            return rows.filter((r) => r.variantId === null);
+        }
+        return rows;
+    }
+    async findPrimaryMedia(entityId, variantId, ctx) {
+        const media = await this.findEntityMediaByRole(entityId, "primary", variantId, ctx);
+        return media[0];
+    }
+    async createEntityMedia(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(entityMedia).values(data).returning();
+        return rows[0];
+    }
+    async createEntityMediaBatch(data, ctx) {
+        if (data.length === 0)
+            return [];
+        const db = this.getDb(ctx);
+        return db.insert(entityMedia).values(data).returning();
+    }
+    async updateEntityMediaSortOrder(entityId, mediaAssetId, sortOrder, variantId, ctx) {
+        const db = this.getDb(ctx);
+        const conditions = [
+            eq(entityMedia.entityId, entityId),
+            eq(entityMedia.mediaAssetId, mediaAssetId),
+        ];
+        if (variantId !== undefined) {
+            conditions.push(eq(entityMedia.variantId, variantId));
+        }
+        const rows = await db
+            .update(entityMedia)
+            .set({ sortOrder })
+            .where(and(...conditions))
+            .returning();
+        if (variantId === undefined) {
+            return rows.find((r) => r.variantId === null);
+        }
+        return rows[0];
+    }
+    async removeEntityMedia(entityId, mediaAssetId, variantId, ctx) {
+        const db = this.getDb(ctx);
+        const conditions = [
+            eq(entityMedia.entityId, entityId),
+            eq(entityMedia.mediaAssetId, mediaAssetId),
+        ];
+        if (variantId !== undefined) {
+            conditions.push(eq(entityMedia.variantId, variantId));
+        }
+        const result = await db
+            .delete(entityMedia)
+            .where(and(...conditions))
+            .returning();
+        if (variantId === undefined) {
+            return result.some((r) => r.variantId === null);
+        }
+        return result.length > 0;
+    }
+    async removeAllEntityMedia(entityId, ctx) {
+        const db = this.getDb(ctx);
+        await db.delete(entityMedia).where(eq(entityMedia.entityId, entityId));
+    }
+    async removeAllMediaByAssetId(mediaAssetId, ctx) {
+        const db = this.getDb(ctx);
+        await db
+            .delete(entityMedia)
+            .where(eq(entityMedia.mediaAssetId, mediaAssetId));
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Aggregates
+    // ─────────────────────────────────────────────────────────────────────────────
+    async findAssetsForEntity(entityId, variantId, ctx) {
+        const associations = await this.findEntityMedia(entityId, variantId, ctx);
+        const assetIds = associations.map((a) => a.mediaAssetId);
+        if (assetIds.length === 0)
+            return [];
+        return this.findAssetsByIds(assetIds, ctx);
+    }
+}