@nextsparkjs/core 0.1.0-beta.75 → 0.1.0-beta.76

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

@@ -0,0 +1,154 @@
+/**
+ * Documentation Service
+ *
+ * Service layer for documentation operations following the project's
+ * service pattern. Provides a consistent API for docs operations.
+ *
+ * NOTE: This service wraps the auto-generated registry functions
+ * and adds additional utility methods.
+ */
+import type { DocPageMeta, DocSectionMeta, DocsRegistryStructure } from '../../types/docs';
+/**
+ * Documentation Service
+ *
+ * Static service class for documentation operations
+ */
+export declare class DocsService {
+    /**
+     * Get the full documentation registry
+     */
+    static getRegistry(): DocsRegistryStructure;
+    /**
+     * Get all documentation sections (public + superadmin)
+     */
+    static getAll(): DocSectionMeta[];
+    /**
+     * Get public documentation sections (for /docs)
+     */
+    static getPublic(): DocSectionMeta[];
+    /**
+     * Get superadmin documentation sections (for /superadmin/docs)
+     */
+    static getSuperadmin(): DocSectionMeta[];
+    /**
+     * Find a section by slug across all categories
+     */
+    static findSection(slug: string): DocSectionMeta | undefined;
+    /**
+     * Find a section by slug in a specific category
+     */
+    static findSectionInCategory(slug: string, category: 'public' | 'superadmin'): DocSectionMeta | undefined;
+    /**
+     * Check if a section exists
+     */
+    static sectionExists(slug: string): boolean;
+    /**
+     * Get all section slugs
+     */
+    static getSectionSlugs(): string[];
+    /**
+     * Get section count
+     */
+    static getSectionCount(): number;
+    /**
+     * Find a page within a section
+     */
+    static findPage(sectionSlug: string, pageSlug: string): DocPageMeta | undefined;
+    /**
+     * Check if a page exists
+     */
+    static pageExists(sectionSlug: string, pageSlug: string): boolean;
+    /**
+     * Get all pages in a section
+     */
+    static getPages(sectionSlug: string): DocPageMeta[];
+    /**
+     * Get total page count across all sections
+     */
+    static getPageCount(): number;
+    /**
+     * Get all pages as a flat array
+     */
+    static getAllPages(): DocPageMeta[];
+    /**
+     * Build the URL path for a page
+     *
+     * @param category - 'public' or 'superadmin'
+     * @param sectionSlug - Section slug
+     * @param pageSlug - Page slug
+     * @returns URL path string
+     */
+    static buildPageUrl(category: 'public' | 'superadmin', sectionSlug: string, pageSlug: string): string;
+    /**
+     * Build the URL path for a section
+     *
+     * @param category - 'public' or 'superadmin'
+     * @param sectionSlug - Section slug
+     * @returns URL path string
+     */
+    static buildSectionUrl(category: 'public' | 'superadmin', sectionSlug: string): string;
+    /**
+     * Parse a URL path to extract category, section, and page
+     *
+     * @param pathname - URL pathname (e.g., '/docs/getting-started/intro')
+     * @returns Parsed path info or null if invalid
+     */
+    static parsePath(pathname: string): {
+        category: 'public' | 'superadmin';
+        sectionSlug: string | null;
+        pageSlug: string | null;
+    } | null;
+    /**
+     * Search across all documentation
+     *
+     * @param query - Search query string
+     * @param category - Optional category filter
+     * @returns Filtered sections with matching pages
+     */
+    static search(query: string, category?: 'public' | 'superadmin'): DocSectionMeta[];
+    /**
+     * Get the first page of the first section (landing page)
+     *
+     * @param category - 'public' or 'superadmin'
+     * @returns First page or undefined
+     */
+    static getFirstPage(category: 'public' | 'superadmin'): DocPageMeta | undefined;
+    /**
+     * Get previous and next pages for navigation
+     *
+     * @param category - 'public' or 'superadmin'
+     * @param sectionSlug - Current section slug
+     * @param pageSlug - Current page slug
+     * @returns Previous and next page info
+     */
+    static getNavigation(category: 'public' | 'superadmin', sectionSlug: string, pageSlug: string): {
+        prev: {
+            section: DocSectionMeta;
+            page: DocPageMeta;
+        } | null;
+        next: {
+            section: DocSectionMeta;
+            page: DocPageMeta;
+        } | null;
+    };
+    /**
+     * Get documentation metadata/stats
+     */
+    static getMetadata(): {
+        publicSections: number;
+        superadminSections: number;
+        totalSections: number;
+        publicPages: number;
+        superadminPages: number;
+        totalPages: number;
+        sectionSlugs: string[];
+    };
+}
+export declare const getDocsRegistry: () => DocsRegistryStructure;
+export declare const getAllDocs: () => DocSectionMeta[];
+export declare const getPublicDocs: () => DocSectionMeta[];
+export declare const getSuperadminDocs: () => DocSectionMeta[];
+export declare const findDocsSection: (slug: string) => DocSectionMeta;
+export declare const findDocsPage: (sectionSlug: string, pageSlug: string) => DocPageMeta;
+export declare const searchDocs: (query: string, category?: "public" | "superadmin") => DocSectionMeta[];
+//# sourceMappingURL=docs.service.d.ts.map

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

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

package/dist/lib/services/entity-type.service.d.ts

@@ -0,0 +1,124 @@
+/**
+ * EntityTypeService - Provides runtime entity type queries
+ *
+ * This service layer abstracts entity-types registry access, making the registry
+ * a pure data structure (Data-Only pattern). All query logic lives here.
+ *
+ * Performance: All operations are O(1) with zero I/O.
+ *
+ * @example
+ * ```typescript
+ * import { EntityTypeService } from './'
+ *
+ * // Check if a type is an entity (vs system type)
+ * const isEntity = EntityTypeService.isEntityType('customers') // true
+ * const isSystem = EntityTypeService.isEntityType('page') // false
+ *
+ * // Get all entity names
+ * const names = EntityTypeService.getAllNames() // ['customers', 'pages', ...]
+ *
+ * // Get search priority for a type
+ * const priority = EntityTypeService.getPriority('customers') // 14
+ * ```
+ */
+import { ENTITY_METADATA, type EntityName, type SearchResultType, type SystemSearchType } from '@nextsparkjs/registries/entity-types';
+export type { EntityName, SearchResultType, SystemSearchType };
+/**
+ * EntityTypeService
+ *
+ * Static service class for entity type queries.
+ * All methods are static - this class is not meant to be instantiated.
+ */
+export declare class EntityTypeService {
+    /**
+     * Check if a type is an entity type (vs system type)
+     *
+     * @param type - The search result type to check
+     * @returns True if the type is an entity, false if it's a system type
+     *
+     * @example
+     * ```typescript
+     * EntityTypeService.isEntityType('customers') // true
+     * EntityTypeService.isEntityType('page') // false
+     * EntityTypeService.isEntityType('setting') // false
+     * ```
+     */
+    static isEntityType(type: SearchResultType): type is EntityName;
+    /**
+     * Get all available entity names
+     *
+     * @returns Array of all entity names from the registry
+     *
+     * @example
+     * ```typescript
+     * const names = EntityTypeService.getAllNames()
+     * // ['customers', 'pages', 'posts', 'tasks']
+     * ```
+     */
+    static getAllNames(): EntityName[];
+    /**
+     * Get search priority for a result type
+     *
+     * Higher numbers indicate higher priority in search results.
+     * Returns 0 for unknown types.
+     *
+     * @param type - The search result type
+     * @returns Priority number (higher = more relevant)
+     *
+     * @example
+     * ```typescript
+     * EntityTypeService.getPriority('customers') // 14
+     * EntityTypeService.getPriority('page') // 5
+     * EntityTypeService.getPriority('unknown') // 0
+     * ```
+     */
+    static getPriority(type: SearchResultType): number;
+    /**
+     * Get all system types (non-entity types)
+     *
+     * @returns Array of system search types
+     *
+     * @example
+     * ```typescript
+     * const systemTypes = EntityTypeService.getSystemTypes()
+     * // ['task', 'page', 'setting', 'entity']
+     * ```
+     */
+    static getSystemTypes(): readonly SystemSearchType[];
+    /**
+     * Get metadata about the entity types registry
+     *
+     * @returns Registry metadata object
+     *
+     * @example
+     * ```typescript
+     * const meta = EntityTypeService.getMetadata()
+     * // { totalEntities: 4, entityNames: [...], generatedAt: '...', source: '...' }
+     * ```
+     */
+    static getMetadata(): typeof ENTITY_METADATA;
+    /**
+     * Get the total count of registered entities
+     *
+     * @returns Number of entities
+     *
+     * @example
+     * ```typescript
+     * const count = EntityTypeService.getCount() // 4
+     * ```
+     */
+    static getCount(): number;
+}
+/**
+ * @deprecated Use EntityTypeService.isEntityType() instead
+ */
+export declare const isEntityType: typeof EntityTypeService.isEntityType;
+/**
+ * @deprecated Use EntityTypeService.getAllNames() instead
+ */
+export declare const getAllEntityNames: typeof EntityTypeService.getAllNames;
+/**
+ * @deprecated Use EntityTypeService.getPriority() instead
+ */
+export declare const getSearchTypePriority: typeof EntityTypeService.getPriority;
+//# sourceMappingURL=entity-type.service.d.ts.map

package/dist/lib/services/entity-type.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-type.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/entity-type.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAEL,eAAe,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,sCAAsC,CAAA;AAG7C,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA;AAQ9D;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,IAAI,UAAU;IAI/D;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW,IAAI,UAAU,EAAE;IAKlC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM;IAIlD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,IAAI,SAAS,gBAAgB,EAAE;IAIpD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO,eAAe;IAI5C;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM;CAG1B;AAQD;;GAEG;AACH,eAAO,MAAM,YAAY,uCAAiC,CAAA;AAE1D;;GAEG;AACH,eAAO,MAAM,iBAAiB,sCAAgC,CAAA;AAE9D;;GAEG;AACH,eAAO,MAAM,qBAAqB,sCAAgC,CAAA"}

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

@@ -0,0 +1,100 @@
+/**
+ * Feature Service
+ *
+ * Provides feature and flow query operations.
+ * Uses pre-computed data from testing-registry for O(1) operations.
+ *
+ * @module FeatureService
+ */
+import { TAGS_REGISTRY, type FeatureEntry, type FlowEntry, type FeatureCategory, type FlowCategory } from '@nextsparkjs/registries/testing-registry';
+/**
+ * Feature Service - Provides runtime feature/flow queries
+ *
+ * This service layer abstracts feature registry access, making the registry
+ * a pure data structure (Data-Only pattern). All query logic lives here.
+ *
+ * Performance: All operations are O(1) or O(n) with zero I/O.
+ */
+export declare class FeatureService {
+    /**
+     * Get a feature by key
+     */
+    static getFeature(key: string): FeatureEntry | undefined;
+    /**
+     * Get all features
+     */
+    static getAllFeatures(): FeatureEntry[];
+    /**
+     * Get features by category
+     */
+    static getFeaturesByCategory(category: FeatureCategory): FeatureEntry[];
+    /**
+     * Get features without test coverage
+     */
+    static getFeaturesWithoutTests(): FeatureEntry[];
+    /**
+     * Get features with test coverage
+     */
+    static getFeaturesWithTests(): FeatureEntry[];
+    /**
+     * Check if a feature exists
+     */
+    static hasFeature(key: string): boolean;
+    /**
+     * Get feature tag from key
+     */
+    static getFeatureTag(key: string): string;
+    /**
+     * Get a flow by key
+     */
+    static getFlow(key: string): FlowEntry | undefined;
+    /**
+     * Get all flows
+     */
+    static getAllFlows(): FlowEntry[];
+    /**
+     * Get flows by category
+     */
+    static getFlowsByCategory(category: FlowCategory): FlowEntry[];
+    /**
+     * Get critical path flows
+     */
+    static getCriticalFlows(): FlowEntry[];
+    /**
+     * Get flows without test coverage
+     */
+    static getFlowsWithoutTests(): FlowEntry[];
+    /**
+     * Check if a flow exists
+     */
+    static hasFlow(key: string): boolean;
+    /**
+     * Get flow tag from key
+     */
+    static getFlowTag(key: string): string;
+    /**
+     * Get all tags in a category
+     */
+    static getTagsByCategory(category: keyof typeof TAGS_REGISTRY): any;
+    /**
+     * Get all feature tags
+     */
+    static getFeatureTags(): any;
+    /**
+     * Get all flow tags
+     */
+    static getFlowTags(): any;
+    /**
+     * Get coverage summary
+     */
+    static getCoverageSummary(): any;
+    /**
+     * Get feature coverage percentage
+     */
+    static getFeatureCoveragePercent(): number;
+    /**
+     * Get flow coverage percentage
+     */
+    static getFlowCoveragePercent(): number;
+}
+//# sourceMappingURL=feature.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/feature.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAGL,aAAa,EAEb,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,0CAA0C,CAAA;AAEjD;;;;;;;GAOG;AACH,qBAAa,cAAc;IAKzB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIxD;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,YAAY,EAAE;IAIvC;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,YAAY,EAAE;IAIvE;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,YAAY,EAAE;IAIhD;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,YAAY,EAAE;IAI7C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQzC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIlD;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,SAAS,EAAE;IAIjC;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE;IAI9D;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,SAAS,EAAE;IAItC;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI,SAAS,EAAE;IAI1C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQtC;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,OAAO,aAAa;IAI7D;;OAEG;IACH,MAAM,CAAC,cAAc;IAIrB;;OAEG;IACH,MAAM,CAAC,WAAW;IAQlB;;OAEG;IACH,MAAM,CAAC,kBAAkB;IAIzB;;OAEG;IACH,MAAM,CAAC,yBAAyB,IAAI,MAAM;IAK1C;;OAEG;IACH,MAAM,CAAC,sBAAsB,IAAI,MAAM;CAIxC"}

package/dist/lib/services/generic-entity.service.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Generic Entity Service
+ *
+ * Provides generic CRUD operations for any entity by slug.
+ * Unlike BaseEntityService (which is abstract and extended per-entity),
+ * this service allows operations on any registered entity dynamically.
+ *
+ * Used by Server Actions to perform entity operations without
+ * needing entity-specific service classes.
+ *
+ * @example
+ * ```typescript
+ * // Create a school record
+ * const school = await GenericEntityService.create('schools', userId, teamId, {
+ *   name: 'MIT',
+ *   status: 'active'
+ * })
+ *
+ * // List campaigns with filtering
+ * const result = await GenericEntityService.list('campaigns', userId, {
+ *   where: { status: 'active' },
+ *   limit: 20
+ * })
+ * ```
+ */
+import type { EntityConfig } from '../entities/types';
+export interface GenericListOptions {
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDir?: 'asc' | 'desc';
+    where?: Record<string, unknown>;
+    search?: string;
+    teamId?: string;
+}
+export interface GenericListResult<T> {
+    data: T[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate entity data against the entity configuration schema
+ *
+ * Validates field types, required fields, and selection options.
+ * Can be used to pre-validate data before calling create/update actions.
+ *
+ * @param entityConfig - Entity configuration with field definitions
+ * @param data - Data to validate
+ * @param isUpdate - If true, required fields are not enforced (partial update)
+ * @returns Validation result with { valid: boolean, errors: string[] }
+ *
+ * @example
+ * ```typescript
+ * import { entityRegistry } from '@nextsparkjs/core/entities'
+ * import { validateEntityData } from '@nextsparkjs/core/services'
+ *
+ * const config = entityRegistry.get('schools')
+ * const result = validateEntityData(config, formData, false)
+ *
+ * if (!result.valid) {
+ *   console.error('Validation errors:', result.errors)
+ * }
+ * ```
+ */
+export declare function validateEntityData(entityConfig: EntityConfig, data: Record<string, unknown>, isUpdate?: boolean): ValidationResult;
+export declare class GenericEntityService {
+    /**
+     * Get entity by ID
+     *
+     * @param entitySlug - The entity type slug (e.g., 'campaigns', 'schools')
+     * @param id - Entity ID
+     * @param userId - Current user ID for RLS
+     * @param teamId - Team ID for team isolation (prevents cross-team access)
+     * @returns Entity or null if not found
+     */
+    static getById<T = unknown>(entitySlug: string, id: string, userId: string, teamId?: string): Promise<T | null>;
+    /**
+     * List entities with pagination, filtering, and search
+     *
+     * @param entitySlug - The entity type slug
+     * @param userId - Current user ID for RLS
+     * @param options - List options (limit, offset, where, search, orderBy)
+     * @returns Paginated result with data and total count
+     */
+    static list<T = unknown>(entitySlug: string, userId: string, options?: GenericListOptions): Promise<GenericListResult<T>>;
+    /**
+     * Create a new entity
+     *
+     * @param entitySlug - The entity type slug
+     * @param userId - Current user ID for RLS and ownership
+     * @param teamId - Team ID for team isolation
+     * @param data - Entity data
+     * @returns Created entity
+     */
+    static create<T = unknown>(entitySlug: string, userId: string, teamId: string, data: Record<string, unknown>): Promise<T>;
+    /**
+     * Update an existing entity
+     *
+     * @param entitySlug - The entity type slug
+     * @param id - Entity ID
+     * @param userId - Current user ID for RLS
+     * @param data - Fields to update
+     * @param teamId - Team ID for team isolation (prevents cross-team access)
+     * @returns Updated entity
+     */
+    static update<T = unknown>(entitySlug: string, id: string, userId: string, data: Record<string, unknown>, teamId?: string): Promise<T>;
+    /**
+     * Delete an entity
+     *
+     * @param entitySlug - The entity type slug
+     * @param id - Entity ID
+     * @param userId - Current user ID for RLS
+     * @param teamId - Team ID for team isolation (prevents cross-team access)
+     * @returns true if deleted, false if not found
+     */
+    static delete(entitySlug: string, id: string, userId: string, teamId?: string): Promise<boolean>;
+    /**
+     * Check if an entity exists
+     *
+     * @param entitySlug - The entity type slug
+     * @param id - Entity ID
+     * @param userId - Current user ID for RLS
+     * @param teamId - Team ID for team isolation (prevents cross-team access)
+     * @returns true if exists and accessible
+     */
+    static exists(entitySlug: string, id: string, userId: string, teamId?: string): Promise<boolean>;
+    /**
+     * Count entities with optional filtering
+     *
+     * @param entitySlug - The entity type slug
+     * @param userId - Current user ID for RLS
+     * @param where - Filter conditions
+     * @returns Count of matching entities
+     */
+    static count(entitySlug: string, userId: string, where?: Record<string, unknown>): Promise<number>;
+    /**
+     * Delete multiple entities in a single query (batch operation)
+     *
+     * More efficient than calling delete() in a loop.
+     *
+     * @param entitySlug - The entity type slug
+     * @param ids - Array of entity IDs to delete
+     * @param userId - Current user ID for RLS
+     * @param options - Optional configuration
+     * @param options.executeHooks - If true, executes hooks for each entity (less efficient). Default: false
+     * @param options.teamId - Team ID for team isolation (prevents cross-team access)
+     * @returns Number of entities deleted
+     *
+     * @note When executeHooks is false (default), uses a single atomic DELETE query.
+     * When executeHooks is true, deletes are performed sequentially and are NOT transactional.
+     * If one delete fails mid-batch, previous deletes remain committed.
+     */
+    static deleteMany(entitySlug: string, ids: string[], userId: string, options?: {
+        executeHooks?: boolean;
+        teamId?: string;
+    }): Promise<number>;
+}
+//# sourceMappingURL=generic-entity.service.d.ts.map

package/dist/lib/services/generic-entity.service.d.ts.map

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

package/dist/lib/services/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Services Module
+ *
+ * Centralized exports for all service classes.
+ * Import services from this module for consistency.
+ *
+ * @example
+ * import { UserService, MetaService, PlanService } from './'
+ */
+export { UserService } from './user.service';
+export { MetaService } from './meta.service';
+export { PlanService } from './plan.service';
+export { SubscriptionService } from './subscription.service';
+export { UsageService } from './usage.service';
+export { InvoiceService } from './invoice.service';
+export { TeamService } from './team.service';
+export { TeamMemberService } from './team-member.service';
+export { PermissionService } from './permission.service';
+export { MembershipService, TeamMembership } from './membership.service';
+export { ThemeService, getThemeAppConfig } from './theme.service';
+export { EntityTypeService } from './entity-type.service';
+export { NamespaceService } from './namespace.service';
+export { MiddlewareService, hasThemeMiddleware, executeThemeMiddleware, addUserHeadersMiddleware } from './middleware.service';
+export { ScopeService } from './scope.service';
+export { RouteHandlerService } from './route-handler.service';
+export { PluginService, usePlugin } from './plugin.service';
+export { ApiRoutesService } from './api-routes.service';
+export { DocsService, getDocsRegistry, getAllDocs, getPublicDocs, getSuperadminDocs, findDocsSection, findDocsPage, searchDocs, } from './docs.service';
+export { GenericEntityService } from './generic-entity.service';
+export { PatternUsageService } from './pattern-usage.service';
+export { TransactionalMetaService } from './transactional-meta.service';
+export type { UpdateUserPayload } from './user.service';
+export type { ListPlansOptions } from './plan.service';
+export type { CreateSubscriptionOptions, ChangePlanResult } from './subscription.service';
+export type { TrackUsageParams, UsageTimelineOptions } from './usage.service';
+export type { ListInvoicesOptions, ListInvoicesResult, CreateInvoicePayload } from './invoice.service';
+export type { TeamWithMemberCount, TeamWithDetails, UpdateTeamPayload } from './team.service';
+export type { TeamMemberWithUser, AddMemberOptions } from './team-member.service';
+export type { ThemeRegistryEntry, ThemeEntity, ThemeRouteFile, ThemeName } from './theme.service';
+export type { EntityName, SearchResultType, SystemSearchType } from './entity-type.service';
+export type { RouteNamespaceConfig, NamespaceConfig, RouteStrategy } from './namespace.service';
+export type { MiddlewareRegistryEntry } from './middleware.service';
+export type { ScopeConfig, ApiConfig, RestrictionRule } from './scope.service';
+export type { RouteHandler } from './route-handler.service';
+export type { PluginRegistryEntry, RouteFileEndpoint, PluginEntity, PluginName, PluginConfig, RouteMetadata } from './plugin.service';
+export type { ApiRouteEntry, RouteCategory } from './api-routes.service';
+export type { GenericListOptions, GenericListResult } from './generic-entity.service';
+export type { PatternUsage, PatternUsageWithEntityInfo, PatternUsageCount, GetUsagesOptions, GetUsagesResult } from './pattern-usage.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/services/index.d.ts.map

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

package/dist/lib/services/index.js

@@ -33,6 +33,7 @@ import {
 } 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,
@@ -54,6 +55,7 @@ export {
   TeamMembership,
   TeamService,
   ThemeService,
+  TransactionalMetaService,
   UsageService,
   UserService,
   addUserHeadersMiddleware,