@nextsparkjs/core 0.1.0-beta.8 → 0.1.0-beta.81

package/dist/lib/services/index.js

@@ -1,29 +1,50 @@
-import { UserService } from "./user.service";
-import { MetaService } from "./meta.service";
-import { PlanService } from "./plan.service";
-import { SubscriptionService } from "./subscription.service";
-import { UsageService } from "./usage.service";
-import { InvoiceService } from "./invoice.service";
-import { TeamService } from "./team.service";
-import { TeamMemberService } from "./team-member.service";
-import { PermissionService } from "./permission.service";
-import { MembershipService, TeamMembership } from "./membership.service";
-import { ThemeService } from "./theme.service";
-import { EntityTypeService } from "./entity-type.service";
-import { NamespaceService } from "./namespace.service";
-import { MiddlewareService } from "./middleware.service";
-import { ScopeService } from "./scope.service";
-import { RouteHandlerService } from "./route-handler.service";
-import { PluginService, usePlugin } from "./plugin.service";
-import { ApiRoutesService } from "./api-routes.service";
+import { UserService } from "./user.service.js";
+import { MetaService } from "./meta.service.js";
+import { PlanService } from "./plan.service.js";
+import { SubscriptionService } from "./subscription.service.js";
+import { UsageService } from "./usage.service.js";
+import { InvoiceService } from "./invoice.service.js";
+import { TeamService } from "./team.service.js";
+import { TeamMemberService } from "./team-member.service.js";
+import { PermissionService } from "./permission.service.js";
+import { MembershipService, TeamMembership } from "./membership.service.js";
+import { ThemeService, getThemeAppConfig } from "./theme.service.js";
+import { EntityTypeService } from "./entity-type.service.js";
+import { NamespaceService } from "./namespace.service.js";
+import {
+  MiddlewareService,
+  hasThemeMiddleware,
+  executeThemeMiddleware,
+  addUserHeadersMiddleware
+} from "./middleware.service.js";
+import { ScopeService } from "./scope.service.js";
+import { RouteHandlerService } from "./route-handler.service.js";
+import { PluginService, usePlugin } from "./plugin.service.js";
+import { ApiRoutesService } from "./api-routes.service.js";
+import {
+  DocsService,
+  getDocsRegistry,
+  getAllDocs,
+  getPublicDocs,
+  getSuperadminDocs,
+  findDocsSection,
+  findDocsPage,
+  searchDocs
+} from "./docs.service.js";
+import { GenericEntityService } from "./generic-entity.service.js";
+import { PatternUsageService } from "./pattern-usage.service.js";
+import { TransactionalMetaService } from "./transactional-meta.service.js";
 export {
   ApiRoutesService,
+  DocsService,
   EntityTypeService,
+  GenericEntityService,
   InvoiceService,
   MembershipService,
   MetaService,
   MiddlewareService,
   NamespaceService,
+  PatternUsageService,
   PermissionService,
   PlanService,
   PluginService,
@@ -34,7 +55,19 @@ export {
   TeamMembership,
   TeamService,
   ThemeService,
+  TransactionalMetaService,
   UsageService,
   UserService,
+  addUserHeadersMiddleware,
+  executeThemeMiddleware,
+  findDocsPage,
+  findDocsSection,
+  getAllDocs,
+  getDocsRegistry,
+  getPublicDocs,
+  getSuperadminDocs,
+  getThemeAppConfig,
+  hasThemeMiddleware,
+  searchDocs,
   usePlugin
 };

package/dist/lib/services/invoice.service.js

@@ -1,4 +1,4 @@
-import { queryOneWithRLS, queryWithRLS, mutateWithRLS } from "../db";
+import { queryOneWithRLS, queryWithRLS, mutateWithRLS } from "../db.js";
 const INVOICE_SELECT_COLUMNS = `
   id,
   "teamId",

package/dist/lib/services/membership.service.js

@@ -1,8 +1,8 @@
-import { APP_CONFIG_MERGED } from "../config/config-sync";
-import { TeamMemberService } from "./team-member.service";
-import { SubscriptionService } from "./subscription.service";
-import { PermissionService } from "./permission.service";
-import { PlanService } from "./plan.service";
+import { APP_CONFIG_MERGED } from "../config/config-sync.js";
+import { TeamMemberService } from "./team-member.service.js";
+import { SubscriptionService } from "./subscription.service.js";
+import { PermissionService } from "./permission.service.js";
+import { PlanService } from "./plan.service.js";
 class TeamMembership {
   userId;
   teamId;

package/dist/lib/services/meta.service.js

@@ -1,7 +1,7 @@
-import { queryWithRLS, mutateWithRLS } from "../db";
+import { queryWithRLS, mutateWithRLS } from "../db.js";
 import {
   getEntityMetaConfig
-} from "../../types/meta.types";
+} from "../../types/meta.types.js";
 class MetaService {
   /**
    * Obtener configuración de entidad

package/dist/lib/services/pattern-usage.service.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Pattern Usage Service
+ *
+ * Tracks which entities (pages, posts, etc.) use each pattern.
+ * Provides sync, query, and count operations for pattern usage tracking.
+ *
+ * @module PatternUsageService
+ */
+import type { BlockInstance } from '../../types/blocks';
+import type { PatternReference } from '../../types/pattern-reference';
+export interface PatternUsage {
+    id: string;
+    patternId: string;
+    entityType: string;
+    entityId: string;
+    teamId: string;
+    createdAt: string;
+}
+export interface PatternUsageWithEntityInfo extends PatternUsage {
+    entityTitle?: string;
+    entityName?: string;
+    entityFirstName?: string;
+    entityLastName?: string;
+    entityEmail?: string;
+    entitySlug?: string;
+    entityStatus?: string;
+    entityUpdatedAt?: string;
+}
+export interface PatternUsageCount {
+    entityType: string;
+    count: number;
+}
+export interface GetUsagesOptions {
+    entityType?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface GetUsagesResult {
+    usages: PatternUsageWithEntityInfo[];
+    counts: PatternUsageCount[];
+    total: number;
+}
+export declare class PatternUsageService {
+    /**
+     * Sync pattern usages for an entity
+     *
+     * Extracts pattern references from blocks and updates the usage table.
+     * Uses diff-based approach: only adds new and removes old references.
+     *
+     * @param entityType - Type of entity (e.g., 'pages', 'posts')
+     * @param entityId - ID of the entity
+     * @param teamId - Team ID for isolation
+     * @param blocks - Array of blocks that may contain pattern references
+     * @param userId - User ID for RLS
+     */
+    static syncUsages(entityType: string, entityId: string, teamId: string, blocks: (BlockInstance | PatternReference)[], userId: string): Promise<void>;
+    /**
+     * Remove all usages for an entity (on delete)
+     *
+     * @param entityType - Type of entity
+     * @param entityId - ID of the entity
+     * @param userId - User ID for RLS
+     */
+    static removeEntityUsages(entityType: string, entityId: string, userId: string): Promise<void>;
+    /**
+     * Get usage count for a pattern
+     *
+     * @param patternId - Pattern ID
+     * @param userId - User ID for RLS
+     * @returns Total usage count
+     */
+    static getUsageCount(patternId: string, userId: string): Promise<number>;
+    /**
+     * Get usage counts grouped by entity type
+     *
+     * @param patternId - Pattern ID
+     * @param userId - User ID for RLS
+     * @returns Array of counts by entity type
+     */
+    static getUsageCounts(patternId: string, userId: string): Promise<PatternUsageCount[]>;
+    /**
+     * Get detailed usages with entity information
+     *
+     * Joins with entity tables to get title, slug, status, etc.
+     *
+     * @param patternId - Pattern ID
+     * @param userId - User ID for RLS
+     * @param options - Filtering and pagination options
+     * @returns Usages with entity info, counts, and total
+     */
+    static getUsagesWithEntityInfo(patternId: string, userId: string, options?: GetUsagesOptions): Promise<GetUsagesResult>;
+    /**
+     * Enrich usages with entity information
+     *
+     * Batches queries by entity type for efficiency.
+     *
+     * @param usages - Array of pattern usages
+     * @param userId - User ID for RLS
+     * @returns Usages with entity info added
+     */
+    private static enrichUsagesWithEntityInfo;
+    /**
+     * Get all pattern IDs that have usages
+     * Useful for checking if any patterns are in use before bulk operations
+     *
+     * @param patternIds - Array of pattern IDs to check
+     * @param userId - User ID for RLS
+     * @returns Array of pattern IDs that have at least one usage
+     */
+    static getPatternsWithUsages(patternIds: string[], userId: string): Promise<string[]>;
+    /**
+     * Validate which pattern IDs exist in the database
+     *
+     * Returns only the IDs that exist and are accessible.
+     * Used for lazy cleanup - filtering orphaned pattern references on entity save.
+     *
+     * @param patternIds - Array of pattern IDs to check
+     * @param userId - User ID for RLS
+     * @returns Set of pattern IDs that exist
+     */
+    static getExistingPatternIds(patternIds: string[], userId: string): Promise<Set<string>>;
+}
+//# sourceMappingURL=pattern-usage.service.d.ts.map

package/dist/lib/services/pattern-usage.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-usage.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/pattern-usage.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAMrE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,0BAA2B,SAAQ,YAAY;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,0BAA0B,EAAE,CAAA;IACpC,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAMD,qBAAa,mBAAmB;IAC9B;;;;;;;;;;;OAWG;WACU,UAAU,CACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,EAC5C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAwDhB;;;;;;OAMG;WACU,kBAAkB,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAchB;;;;;;OAMG;WACU,aAAa,CACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;IASlB;;;;;;OAMG;WACU,cAAc,CACzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAgB/B;;;;;;;;;OASG;WACU,uBAAuB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAgD3B;;;;;;;;OAQG;mBACkB,0BAA0B;IAgI/C;;;;;;;OAOG;WACU,qBAAqB,CAChC,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC;IAWpB;;;;;;;;;OASG;WACU,qBAAqB,CAChC,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;CAWxB"}

package/dist/lib/services/pattern-usage.service.js

@@ -0,0 +1,282 @@
+import { queryWithRLS, mutateWithRLS, queryOneWithRLS, queryRows } from "../db.js";
+import { extractPatternIds } from "../blocks/pattern-resolver.js";
+import { entityRegistry } from "../entities/registry.js";
+class PatternUsageService {
+  /**
+   * Sync pattern usages for an entity
+   *
+   * Extracts pattern references from blocks and updates the usage table.
+   * Uses diff-based approach: only adds new and removes old references.
+   *
+   * @param entityType - Type of entity (e.g., 'pages', 'posts')
+   * @param entityId - ID of the entity
+   * @param teamId - Team ID for isolation
+   * @param blocks - Array of blocks that may contain pattern references
+   * @param userId - User ID for RLS
+   */
+  static async syncUsages(entityType, entityId, teamId, blocks, userId) {
+    try {
+      const currentPatternIds = new Set(extractPatternIds(blocks));
+      const existingUsages = await queryWithRLS(
+        `SELECT "patternId" FROM pattern_usages
+         WHERE "entityType" = $1 AND "entityId" = $2`,
+        [entityType, entityId],
+        userId
+      );
+      const existingPatternIds = new Set(existingUsages.map((u) => u.patternId));
+      const toAdd = [...currentPatternIds].filter((id) => !existingPatternIds.has(id));
+      const toRemove = [...existingPatternIds].filter((id) => !currentPatternIds.has(id));
+      if (toRemove.length > 0) {
+        await mutateWithRLS(
+          `DELETE FROM pattern_usages
+           WHERE "entityType" = $1 AND "entityId" = $2 AND "patternId" = ANY($3)`,
+          [entityType, entityId, toRemove],
+          userId
+        );
+      }
+      if (toAdd.length > 0) {
+        const insertValues = [];
+        const placeholders = [];
+        let paramIndex = 1;
+        for (const patternId of toAdd) {
+          placeholders.push(`($${paramIndex}, $${paramIndex + 1}, $${paramIndex + 2}, $${paramIndex + 3})`);
+          insertValues.push(patternId, entityType, entityId, teamId);
+          paramIndex += 4;
+        }
+        await mutateWithRLS(
+          `INSERT INTO pattern_usages ("patternId", "entityType", "entityId", "teamId")
+           VALUES ${placeholders.join(", ")}
+           ON CONFLICT ("patternId", "entityType", "entityId") DO NOTHING`,
+          insertValues,
+          userId
+        );
+      }
+      console.log(`[PatternUsageService] Synced usages for ${entityType}/${entityId}: +${toAdd.length} -${toRemove.length}`);
+    } catch (error) {
+      console.error(`[PatternUsageService] Error syncing usages for ${entityType}/${entityId}:`, error);
+    }
+  }
+  /**
+   * Remove all usages for an entity (on delete)
+   *
+   * @param entityType - Type of entity
+   * @param entityId - ID of the entity
+   * @param userId - User ID for RLS
+   */
+  static async removeEntityUsages(entityType, entityId, userId) {
+    try {
+      await mutateWithRLS(
+        `DELETE FROM pattern_usages
+         WHERE "entityType" = $1 AND "entityId" = $2`,
+        [entityType, entityId],
+        userId
+      );
+      console.log(`[PatternUsageService] Removed usages for ${entityType}/${entityId}`);
+    } catch (error) {
+      console.error(`[PatternUsageService] Error removing usages for ${entityType}/${entityId}:`, error);
+    }
+  }
+  /**
+   * Get usage count for a pattern
+   *
+   * @param patternId - Pattern ID
+   * @param userId - User ID for RLS
+   * @returns Total usage count
+   */
+  static async getUsageCount(patternId, userId) {
+    const result = await queryOneWithRLS(
+      `SELECT COUNT(*)::text as count FROM pattern_usages WHERE "patternId" = $1`,
+      [patternId],
+      userId
+    );
+    return parseInt((result == null ? void 0 : result.count) || "0", 10);
+  }
+  /**
+   * Get usage counts grouped by entity type
+   *
+   * @param patternId - Pattern ID
+   * @param userId - User ID for RLS
+   * @returns Array of counts by entity type
+   */
+  static async getUsageCounts(patternId, userId) {
+    const results = await queryWithRLS(
+      `SELECT "entityType", COUNT(*)::text as count
+       FROM pattern_usages
+       WHERE "patternId" = $1
+       GROUP BY "entityType"
+       ORDER BY count DESC`,
+      [patternId],
+      userId
+    );
+    return results.map((r) => ({
+      entityType: r.entityType,
+      count: parseInt(r.count, 10)
+    }));
+  }
+  /**
+   * Get detailed usages with entity information
+   *
+   * Joins with entity tables to get title, slug, status, etc.
+   *
+   * @param patternId - Pattern ID
+   * @param userId - User ID for RLS
+   * @param options - Filtering and pagination options
+   * @returns Usages with entity info, counts, and total
+   */
+  static async getUsagesWithEntityInfo(patternId, userId, options = {}) {
+    const { entityType, limit = 50, offset = 0 } = options;
+    let whereClause = 'WHERE pu."patternId" = $1';
+    const params = [patternId];
+    let paramIndex = 2;
+    if (entityType) {
+      whereClause += ` AND pu."entityType" = $${paramIndex}`;
+      params.push(entityType);
+      paramIndex++;
+    }
+    const countResult = await queryOneWithRLS(
+      `SELECT COUNT(*)::text as count FROM pattern_usages pu ${whereClause}`,
+      params,
+      userId
+    );
+    const total = parseInt((countResult == null ? void 0 : countResult.count) || "0", 10);
+    const counts = await this.getUsageCounts(patternId, userId);
+    const usages = await queryWithRLS(
+      `SELECT pu.id, pu."patternId", pu."entityType", pu."entityId", pu."teamId", pu."createdAt"
+       FROM pattern_usages pu
+       ${whereClause}
+       ORDER BY pu."createdAt" DESC
+       LIMIT $${paramIndex} OFFSET $${paramIndex + 1}`,
+      [...params, limit, offset],
+      userId
+    );
+    const enrichedUsages = await this.enrichUsagesWithEntityInfo(usages, userId);
+    return {
+      usages: enrichedUsages,
+      counts,
+      total
+    };
+  }
+  /**
+   * Enrich usages with entity information
+   *
+   * Batches queries by entity type for efficiency.
+   *
+   * @param usages - Array of pattern usages
+   * @param userId - User ID for RLS
+   * @returns Usages with entity info added
+   */
+  static async enrichUsagesWithEntityInfo(usages, userId) {
+    if (usages.length === 0) return [];
+    const usagesByType = /* @__PURE__ */ new Map();
+    for (const usage of usages) {
+      const existing = usagesByType.get(usage.entityType) || [];
+      existing.push(usage);
+      usagesByType.set(usage.entityType, existing);
+    }
+    const entityInfoMap = /* @__PURE__ */ new Map();
+    for (const [entityType, typeUsages] of usagesByType) {
+      const entityIds = typeUsages.map((u) => u.entityId);
+      const entityConfig = entityRegistry.get(entityType);
+      if (!entityConfig) {
+        console.warn(`[PatternUsageService] Unknown entity type: ${entityType}, skipping entity info lookup`);
+        entityInfoMap.set(entityType, /* @__PURE__ */ new Map());
+        continue;
+      }
+      const tableName = entityConfig.tableName || entityConfig.slug;
+      try {
+        const columnsResult = await queryRows(
+          `SELECT column_name
+           FROM information_schema.columns
+           WHERE table_schema = 'public' AND table_name = $1`,
+          [tableName]
+        );
+        const columns = new Set(columnsResult.map((c) => c.column_name));
+        const selectParts = ["id"];
+        if (columns.has("title")) selectParts.push("title");
+        if (columns.has("name")) selectParts.push("name");
+        if (columns.has("firstName")) selectParts.push('"firstName"');
+        if (columns.has("lastName")) selectParts.push('"lastName"');
+        if (columns.has("email")) selectParts.push("email");
+        if (columns.has("slug")) selectParts.push("slug");
+        if (columns.has("status")) selectParts.push("status");
+        if (columns.has("updatedAt")) selectParts.push('"updatedAt"');
+        const entities = await queryWithRLS(
+          `SELECT ${selectParts.join(", ")} FROM "${tableName}" WHERE id = ANY($1)`,
+          [entityIds],
+          userId
+        );
+        const infoMap = /* @__PURE__ */ new Map();
+        for (const entity of entities) {
+          infoMap.set(entity.id, {
+            title: entity.title,
+            name: entity.name,
+            firstName: entity.firstName,
+            lastName: entity.lastName,
+            email: entity.email,
+            slug: entity.slug,
+            status: entity.status,
+            updatedAt: entity.updatedAt
+          });
+        }
+        entityInfoMap.set(entityType, infoMap);
+      } catch (error) {
+        console.error(`[PatternUsageService] Could not fetch entity info for ${entityType}:`, error);
+        entityInfoMap.set(entityType, /* @__PURE__ */ new Map());
+      }
+    }
+    return usages.map((usage) => {
+      const typeInfo = entityInfoMap.get(usage.entityType);
+      const entityInfo = typeInfo == null ? void 0 : typeInfo.get(usage.entityId);
+      return {
+        ...usage,
+        entityTitle: entityInfo == null ? void 0 : entityInfo.title,
+        entityName: entityInfo == null ? void 0 : entityInfo.name,
+        entityFirstName: entityInfo == null ? void 0 : entityInfo.firstName,
+        entityLastName: entityInfo == null ? void 0 : entityInfo.lastName,
+        entityEmail: entityInfo == null ? void 0 : entityInfo.email,
+        entitySlug: entityInfo == null ? void 0 : entityInfo.slug,
+        entityStatus: entityInfo == null ? void 0 : entityInfo.status,
+        entityUpdatedAt: entityInfo == null ? void 0 : entityInfo.updatedAt
+      };
+    });
+  }
+  /**
+   * Get all pattern IDs that have usages
+   * Useful for checking if any patterns are in use before bulk operations
+   *
+   * @param patternIds - Array of pattern IDs to check
+   * @param userId - User ID for RLS
+   * @returns Array of pattern IDs that have at least one usage
+   */
+  static async getPatternsWithUsages(patternIds, userId) {
+    if (patternIds.length === 0) return [];
+    const results = await queryWithRLS(
+      `SELECT DISTINCT "patternId" FROM pattern_usages WHERE "patternId" = ANY($1)`,
+      [patternIds],
+      userId
+    );
+    return results.map((r) => r.patternId);
+  }
+  /**
+   * Validate which pattern IDs exist in the database
+   *
+   * Returns only the IDs that exist and are accessible.
+   * Used for lazy cleanup - filtering orphaned pattern references on entity save.
+   *
+   * @param patternIds - Array of pattern IDs to check
+   * @param userId - User ID for RLS
+   * @returns Set of pattern IDs that exist
+   */
+  static async getExistingPatternIds(patternIds, userId) {
+    if (!patternIds.length) return /* @__PURE__ */ new Set();
+    const result = await queryWithRLS(
+      `SELECT id FROM patterns WHERE id = ANY($1::text[])`,
+      [patternIds],
+      userId
+    );
+    return new Set(result.map((r) => r.id));
+  }
+}
+export {
+  PatternUsageService
+};

package/dist/lib/services/plan.service.js

@@ -1,4 +1,4 @@
-import { queryOneWithRLS, queryWithRLS } from "../db";
+import { queryOneWithRLS, queryWithRLS } from "../db.js";
 import { BILLING_REGISTRY } from "@nextsparkjs/registries/billing-registry";
 class PlanService {
   // ===========================================

package/dist/lib/services/plugin.service.d.ts

@@ -279,6 +279,7 @@ export declare class PluginService {
      *
      * Server-side only. Executes async onLoad hooks for all plugins.
      * Continues with other plugins if one fails.
+     * Uses globalThis cache to prevent re-initialization.
      *
      * @returns Promise that resolves when all plugins are initialized
      *

package/dist/lib/services/plugin.service.d.ts.map

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

package/dist/lib/services/plugin.service.js

@@ -3,6 +3,8 @@ import {
   ROUTE_METADATA,
   PLUGIN_METADATA
 } from "@nextsparkjs/registries/plugin-registry";
+const DEBUG_PLUGINS = process.env.NEXTSPARK_DEBUG_PLUGINS === "true";
+const globalCache = globalThis;
 class PluginService {
   // ============================================================================
   // Core Query Methods (14)
@@ -322,6 +324,7 @@ class PluginService {
    *
    * Server-side only. Executes async onLoad hooks for all plugins.
    * Continues with other plugins if one fails.
+   * Uses globalThis cache to prevent re-initialization.
    *
    * @returns Promise that resolves when all plugins are initialized
    *
@@ -336,22 +339,39 @@ class PluginService {
     if (typeof window !== "undefined") {
       return;
     }
-    console.log("[Plugin Registry] Initializing plugin system...");
+    if (globalCache.__nextspark_plugins_initialized) {
+      if (DEBUG_PLUGINS) {
+        console.log("[Plugin Registry] Already initialized, skipping");
+      }
+      return;
+    }
+    if (DEBUG_PLUGINS) {
+      console.log("[Plugin Registry] Initializing plugin system...");
+    }
     const pluginEntries = Object.values(PLUGIN_REGISTRY);
-    console.log(`[Plugin Registry] Found ${pluginEntries.length} plugins to initialize`);
+    if (DEBUG_PLUGINS) {
+      console.log(`[Plugin Registry] Found ${pluginEntries.length} plugins to initialize`);
+    }
     for (const pluginEntry of pluginEntries) {
       try {
         const plugin = pluginEntry.config;
         if ((_a = plugin.hooks) == null ? void 0 : _a.onLoad) {
-          console.log(`[Plugin Registry] Loading plugin: ${plugin.name}`);
+          if (DEBUG_PLUGINS) {
+            console.log(`[Plugin Registry] Loading plugin: ${plugin.name}`);
+          }
           await plugin.hooks.onLoad();
-          console.log(`[Plugin Registry] \u2705 Plugin ${plugin.name} loaded successfully`);
+          if (DEBUG_PLUGINS) {
+            console.log(`[Plugin Registry] Plugin ${plugin.name} loaded successfully`);
+          }
         }
       } catch (error) {
-        console.error(`[Plugin Registry] \u274C Error loading plugin ${pluginEntry.name}:`, error);
+        console.error(`[Plugin Registry] Error loading plugin ${pluginEntry.name}:`, error);
       }
     }
-    console.log("[Plugin Registry] \u2705 Plugin system initialized successfully");
+    globalCache.__nextspark_plugins_initialized = true;
+    if (DEBUG_PLUGINS) {
+      console.log("[Plugin Registry] Plugin system initialized successfully");
+    }
   }
   // ============================================================================
   // Metadata & Helpers (3)
@@ -419,13 +439,17 @@ function usePlugin(pluginName) {
   var _a;
   const plugin = PLUGIN_REGISTRY[pluginName];
   if (!plugin) {
-    console.warn(`[Plugin Registry] Plugin '${pluginName}' not found`);
+    if (DEBUG_PLUGINS) {
+      console.warn(`[Plugin Registry] Plugin '${pluginName}' not found`);
+    }
     return createPluginStubs(pluginName, "NOT_FOUND");
   }
   if (!((_a = plugin.config) == null ? void 0 : _a.api)) {
-    console.debug(
-      `[Plugin Registry] Plugin '${pluginName}' has no API (normal for config/style/component plugins)`
-    );
+    if (DEBUG_PLUGINS) {
+      console.debug(
+        `[Plugin Registry] Plugin '${pluginName}' has no API (normal for config/style/component plugins)`
+      );
+    }
     return {
       isAvailable: () => true,
       // Plugin exists, just has no API
@@ -480,7 +504,9 @@ function createPluginStubs(pluginName, reason) {
   const stubs = {};
   commonFunctions.forEach((funcName) => {
     stubs[funcName] = async (...args) => {
-      console.warn(`[Plugin '${pluginName}'] ${message}`);
+      if (DEBUG_PLUGINS) {
+        console.warn(`[Plugin '${pluginName}'] ${message}`);
+      }
       return {
         error: true,
         message,