@stndrds/schema 0.1.0-alpha.45 → 0.1.0-alpha.47

package/dist/{chunk-3GHMPTWA.mjs → chunk-CVMMZRH6.mjs}

@@ -323,6 +323,25 @@ function initializePinCodeService(salt) {
 }
 
 // src/runtime/cache.ts
+import { createHash } from "crypto";
+function hashOptions(options) {
+  if (options === null || options === void 0 || typeof options === "object" && Object.keys(options).length === 0) {
+    return "default";
+  }
+  const sortedJson = JSON.stringify(options, (_, value) => {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      return Object.keys(value).sort().reduce(
+        (sorted, key) => {
+          sorted[key] = value[key];
+          return sorted;
+        },
+        {}
+      );
+    }
+    return value;
+  });
+  return createHash("md5").update(sortedJson).digest("hex").slice(0, 8);
+}
 var cacheKeys = {
   // -------------------------------------------------------------------------
   // Schemas - TTL: 1 hour (rarely change)
@@ -361,6 +380,24 @@ var cacheKeys = {
   /** Individual record by ID */
   record: (tenantId, recordId) => `record:${tenantId}:${recordId}`,
   // -------------------------------------------------------------------------
+  // Record Lists - TTL: 1 minute (high volatility)
+  // -------------------------------------------------------------------------
+  /** Record list for an object with options hash */
+  recordList: (tenantId, objectId, hash) => `records:${tenantId}:${objectId}:list:${hash}`,
+  /** All record lists for an object (for invalidation) */
+  allRecordLists: (tenantId, objectId) => `records:${tenantId}:${objectId}:list:*`,
+  // -------------------------------------------------------------------------
+  // Search Results - TTL: 30 seconds (very high volatility)
+  // -------------------------------------------------------------------------
+  /** Search results for an object */
+  searchResults: (tenantId, objectId, hash) => `search:${tenantId}:${objectId}:${hash}`,
+  /** All search results for an object (for invalidation) */
+  allSearchResults: (tenantId, objectId) => `search:${tenantId}:${objectId}:*`,
+  /** Global search results */
+  globalSearch: (tenantId, hash) => `gsearch:${tenantId}:${hash}`,
+  /** All global search results for tenant (for invalidation) */
+  allGlobalSearch: (tenantId) => `gsearch:${tenantId}:*`,
+  // -------------------------------------------------------------------------
   // Invalidation Patterns
   // -------------------------------------------------------------------------
   /** All schema cache for a tenant */
@@ -432,7 +469,34 @@ var cacheTtl = {
   /** User profiles - medium volatility (5 minutes) */
   userProfiles: 5 * 60 * 1e3,
   /** Workflows - rarely change (5 minutes) */
-  workflows: 5 * 60 * 1e3
+  workflows: 5 * 60 * 1e3,
+  /** Record lists - high volatility (1 minute) */
+  recordList: 60 * 1e3,
+  /** Search results - very high volatility (30 seconds) */
+  searchResults: 30 * 1e3,
+  /** Global search - very high volatility (30 seconds) */
+  globalSearch: 30 * 1e3
+};
+var defaultTtl = {
+  record: cacheTtl.records,
+  objectSchema: cacheTtl.schema,
+  objectSchemaByName: cacheTtl.schema,
+  objectSchemaList: cacheTtl.schemaList,
+  objectAttributes: cacheTtl.attributes,
+  attributeById: cacheTtl.attributes,
+  userProfileById: cacheTtl.userProfiles,
+  userProfileByAuthId: cacheTtl.userProfiles,
+  userProfileByEmail: cacheTtl.userProfiles,
+  viewsByObject: cacheTtl.views,
+  workflowByName: cacheTtl.workflows,
+  workflowById: cacheTtl.workflows,
+  workflowList: cacheTtl.workflows,
+  relationOptions: cacheTtl.relations,
+  rollupValue: cacheTtl.rollup,
+  userPermissions: cacheTtl.permissions,
+  recordList: cacheTtl.recordList,
+  searchResults: cacheTtl.searchResults,
+  globalSearch: cacheTtl.globalSearch
 };
 var NoopCacheAdapter = class {
   get() {
@@ -4258,20 +4322,55 @@ var BaseService = class {
     return getUserId();
   }
   // ============================================================================
-  // CACHE UTILITIES
+  // CACHE HELPERS
   // ============================================================================
   /**
-   * Execute a query with caching support.
-   * If cache is not configured, executes the fetcher directly.
+   * Cache a value by key type and ID.
+   * Automatically builds the cache key with tenantId and applies default TTL.
+   *
+   * @param keyType - Type of cache key (e.g., "record", "objectSchema")
+   * @param id - Resource identifier
+   * @param fetcher - Function to fetch data if not cached
+   * @param ttlMs - Optional TTL override (uses default for keyType if not provided)
+   *
+   * @example
+   * ```typescript
+   * return this.cachedBy("record", recordId, () =>
+   *   this.adapter.objectRecords.findById(recordId)
+   * );
+   * ```
+   */
+  cachedBy(keyType, id, fetcher, ttlMs) {
+    if (!this.cache) return fetcher();
+    const keyFn = cacheKeys[keyType];
+    const key = keyFn(this.tenantId, id);
+    const ttl = ttlMs ?? defaultTtl[keyType] ?? 6e4;
+    return this.cache.getOrSet(key, fetcher, ttl);
+  }
+  /**
+   * Cache a list query with automatic options hashing.
+   * Useful for list/search operations with filters, sorts, pagination.
    *
-   * @param key - Cache key
+   * @param keyType - Type of cache key (e.g., "recordList", "searchResults")
+   * @param id - Resource identifier (e.g., objectId)
+   * @param options - Query options to hash (filters, sorts, etc.)
    * @param fetcher - Function to fetch data if not cached
-   * @param ttlMs - Time-to-live in milliseconds
-   * @returns Cached or freshly fetched data
+   * @param ttlMs - Optional TTL override
+   *
+   * @example
+   * ```typescript
+   * return this.cachedList("recordList", objectId, options, () =>
+   *   this.executeListQuery(objectId, options)
+   * );
+   * ```
    */
-  cached(key, fetcher, ttlMs) {
+  cachedList(keyType, id, options, fetcher, ttlMs) {
     if (!this.cache) return fetcher();
-    return this.cache.getOrSet(key, fetcher, ttlMs);
+    const hash = hashOptions(options);
+    const keyFn = cacheKeys[keyType];
+    const key = keyFn(this.tenantId, id, hash);
+    const ttl = ttlMs ?? defaultTtl[keyType] ?? 6e4;
+    return this.cache.getOrSet(key, fetcher, ttl);
   }
   /**
    * Invalidate a specific cache key.
@@ -4289,6 +4388,26 @@ var BaseService = class {
   async invalidateCachePattern(pattern) {
     await this.cache?.deletePattern(pattern);
   }
+  /**
+   * Invalidate all cached lists for a resource.
+   * Call this after create/update/delete operations.
+   *
+   * @param keyType - Invalidation pattern key (e.g., "allRecordLists", "allSearchResults")
+   * @param id - Resource identifier
+   *
+   * @example
+   * ```typescript
+   * // After creating/updating/deleting a record
+   * await this.invalidateLists("allRecordLists", objectId);
+   * await this.invalidateLists("allSearchResults", objectId);
+   * ```
+   */
+  async invalidateLists(keyType, id) {
+    if (!this.cache) return;
+    const patternFn = cacheKeys[keyType];
+    const pattern = patternFn(this.tenantId, id);
+    await this.cache.deletePattern(pattern);
+  }
 };
 var BaseRepository = class {
   /**
@@ -4320,8 +4439,8 @@ var SchemaContextAwareRepository = class extends BaseRepository {
     return getSchemaByNameFromContext(objectName);
   }
 };
-var TenantAwareService = BaseService;
 var TenantAwareRepository = BaseRepository;
+var TenantAwareService = BaseService;
 
 // src/types/attributes.ts
 var RELATION_TARGET_ANY = "*";
@@ -7679,11 +7798,7 @@ Reserved names: ${RESERVED_ATTRIBUTE_NAMES.join(", ")}`
    * @returns Complete ObjectDefinition with all attributes including system attributes
    */
   async getObjectSchema(objectId) {
-    return this.cached(
-      cacheKeys.objectSchema(this.tenantId, objectId),
-      () => this.fetchObjectSchemaById(objectId),
-      cacheTtl.schema
-    );
+    return this.cachedBy("objectSchema", objectId, () => this.fetchObjectSchemaById(objectId));
   }
   /**
    * Internal method to fetch object schema by ID (no caching)
@@ -7702,11 +7817,7 @@ Reserved names: ${RESERVED_ATTRIBUTE_NAMES.join(", ")}`
    * Results are cached if a CacheAdapter is configured.
    */
   async getObjectSchemaByName(name) {
-    return this.cached(
-      cacheKeys.objectSchemaByName(this.tenantId, name),
-      () => this.fetchObjectSchemaByName(name),
-      cacheTtl.schema
-    );
+    return this.cachedBy("objectSchemaByName", name, () => this.fetchObjectSchemaByName(name));
   }
   /**
    * Internal method to fetch object schema by name (no caching)
@@ -7728,11 +7839,7 @@ Reserved names: ${RESERVED_ATTRIBUTE_NAMES.join(", ")}`
    * Results are cached if a CacheAdapter is configured.
    */
   async listObjectSchemas() {
-    return this.cached(
-      cacheKeys.objectSchemaList(this.tenantId),
-      () => this.fetchObjectSchemaList(),
-      cacheTtl.schemaList
-    );
+    return this.cachedBy("objectSchemaList", "all", () => this.fetchObjectSchemaList());
   }
   /**
    * Internal method to fetch all object schemas (no caching)
@@ -8974,7 +9081,12 @@ var RecordQueryService = class extends BaseService {
    */
   async listRecords(objectId, options) {
     const schema = await this.schemaService.getObjectSchema(objectId);
-    return this.executeListQuery(schema, objectId, options);
+    return this.cachedList(
+      "recordList",
+      objectId,
+      { ...options, _userId: this.userId },
+      () => this.executeListQuery(schema, objectId, options)
+    );
   }
   /**
    * List records using a pre-fetched schema.
@@ -8984,7 +9096,13 @@ var RecordQueryService = class extends BaseService {
     if (!schema.id) {
       throw new Error("Schema must have an ID to list records");
     }
-    return await this.executeListQuery(schema, schema.id, options);
+    const objectId = schema.id;
+    return this.cachedList(
+      "recordList",
+      objectId,
+      { ...options, _userId: this.userId },
+      () => this.executeListQuery(schema, objectId, options)
+    );
   }
   /**
    * Internal list query execution
@@ -9043,7 +9161,12 @@ var RecordQueryService = class extends BaseService {
    */
   async searchRecords(objectId, query, options) {
     const schema = await this.schemaService.getObjectSchema(objectId);
-    return this.executeSearchQuery(schema, objectId, query, options);
+    return this.cachedList(
+      "searchResults",
+      objectId,
+      { query, ...options, _userId: this.userId },
+      () => this.executeSearchQuery(schema, objectId, query, options)
+    );
   }
   /**
    * Search records using a pre-fetched schema.
@@ -9053,7 +9176,13 @@ var RecordQueryService = class extends BaseService {
     if (!schema.id) {
       throw new Error("Schema must have an ID to search records");
     }
-    return await this.executeSearchQuery(schema, schema.id, query, options);
+    const objectId = schema.id;
+    return this.cachedList(
+      "searchResults",
+      objectId,
+      { query, ...options, _userId: this.userId },
+      () => this.executeSearchQuery(schema, objectId, query, options)
+    );
   }
   /**
    * Internal search query execution
@@ -9247,6 +9376,18 @@ var RelationService = class extends BaseService {
    * ```
    */
   async getOptions(attribute, params = {}) {
+    const attrKey = attribute.id ?? attribute.name;
+    return this.cachedList(
+      "relationOptions",
+      attrKey,
+      params,
+      () => this.fetchOptions(attribute, params)
+    );
+  }
+  /**
+   * Internal method to fetch relation options (extracted for caching)
+   */
+  async fetchOptions(attribute, params) {
     const { query = "", page = 1, pageSize = 20, targetObject, filter } = params;
     const targets = attribute.targets;
     const filteredTargets = targetObject ? targets.filter((t) => t.object === targetObject) : targets;
@@ -9372,11 +9513,7 @@ var RelationService = class extends BaseService {
    * Cache is invalidated by ObjectSchemaService.invalidateSchemaCache() via allAttributes pattern.
    */
   async findAttributeById(attributeId) {
-    return this.cached(
-      cacheKeys.attributeById(this.tenantId, attributeId),
-      () => this.fetchAttributeById(attributeId),
-      cacheTtl.attributes
-    );
+    return this.cachedBy("attributeById", attributeId, () => this.fetchAttributeById(attributeId));
   }
   /**
    * Internal method to fetch attribute by ID (no caching)
@@ -9430,10 +9567,11 @@ var RollupService = class extends BaseService {
    * ```
    */
   async calculate(recordId, rollupAttr, schema) {
-    return this.cached(
-      cacheKeys.rollupValue(this.tenantId, recordId, rollupAttr.name),
-      () => this.computeRollup(recordId, rollupAttr, schema),
-      cacheTtl.rollup
+    const cacheId = `${recordId}:${rollupAttr.name}`;
+    return this.cachedBy(
+      "rollupValue",
+      cacheId,
+      () => this.computeRollup(recordId, rollupAttr, schema)
     );
   }
   /**
@@ -9863,6 +10001,9 @@ var RecordService = class extends BaseService {
       await this.hookRegistry.execute("afterCreate", schema.name, afterCtx);
     }
     await recalculateParentRollups(record, schema, this.rollupContext);
+    await this.invalidateLists("allRecordLists", objectId);
+    await this.invalidateLists("allSearchResults", objectId);
+    await this.invalidateCachePattern(cacheKeys.allGlobalSearch(this.tenantId));
     if (this.auditService && this.userId) {
       await this.auditService.logRecordAction({
         action: "record.created",
@@ -9883,10 +10024,10 @@ var RecordService = class extends BaseService {
    * Get a record by ID
    */
   async getRecord(recordId, options) {
-    const record = await this.cached(
-      cacheKeys.record(this.tenantId, recordId),
-      () => this.adapter.objectRecords.findById(recordId),
-      cacheTtl.records
+    const record = await this.cachedBy(
+      "record",
+      recordId,
+      () => this.adapter.objectRecords.findById(recordId)
     );
     if (!record) {
       return null;
@@ -9997,6 +10138,8 @@ var RecordService = class extends BaseService {
     }
     const updated = await this.adapter.objectRecords.update(recordId, updatePayload);
     await this.invalidateCache(cacheKeys.record(this.tenantId, recordId));
+    await this.invalidateLists("allRecordLists", existing.objectId);
+    await this.invalidateLists("allSearchResults", existing.objectId);
     if (!options?.skipHooks) {
       const afterCtx = {
         ...hookCtx,
@@ -10061,6 +10204,9 @@ var RecordService = class extends BaseService {
     }
     await this.adapter.objectRecords.delete(recordId);
     await this.invalidateCache(cacheKeys.record(this.tenantId, recordId));
+    await this.invalidateLists("allRecordLists", record.objectId);
+    await this.invalidateLists("allSearchResults", record.objectId);
+    await this.invalidateCachePattern(cacheKeys.allGlobalSearch(this.tenantId));
     if (!options?.skipHooks) {
       await this.hookRegistry.execute("afterDelete", schema.name, hookCtx);
     }
@@ -10086,6 +10232,9 @@ var RecordService = class extends BaseService {
     await checkPermission(this.permissionService, this.userId, schema.name, "delete");
     await this.adapter.objectRecords.hardDelete(recordId);
     await this.invalidateCache(cacheKeys.record(this.tenantId, recordId));
+    await this.invalidateLists("allRecordLists", record.objectId);
+    await this.invalidateLists("allSearchResults", record.objectId);
+    await this.invalidateCachePattern(cacheKeys.allGlobalSearch(this.tenantId));
   }
   // ============================================================================
   // RESTORE
@@ -10110,6 +10259,9 @@ var RecordService = class extends BaseService {
     }
     const restored = await this.adapter.objectRecords.restore(recordId);
     await this.invalidateCache(cacheKeys.record(this.tenantId, recordId));
+    await this.invalidateLists("allRecordLists", record.objectId);
+    await this.invalidateLists("allSearchResults", record.objectId);
+    await this.invalidateCachePattern(cacheKeys.allGlobalSearch(this.tenantId));
     if (!options?.skipHooks) {
       const afterCtx = {
         ...hookCtx,
@@ -10425,11 +10577,7 @@ var WorkflowService = class extends BaseService {
    * Results are cached if a CacheAdapter is configured.
    */
   async getAllWorkflows() {
-    return this.cached(
-      cacheKeys.workflowList(this.tenantId),
-      () => this.fetchAllWorkflows(),
-      cacheTtl.workflows
-    );
+    return this.cachedBy("workflowList", "all", () => this.fetchAllWorkflows());
   }
   /**
    * Internal method to fetch all workflows (no caching)
@@ -10459,11 +10607,7 @@ var WorkflowService = class extends BaseService {
     if (systemWorkflow) {
       return systemWorkflow;
     }
-    return this.cached(
-      cacheKeys.workflowByName(this.tenantId, name),
-      () => this.fetchWorkflowByName(name),
-      cacheTtl.workflows
-    );
+    return this.cachedBy("workflowByName", name, () => this.fetchWorkflowByName(name));
   }
   /**
    * Internal method to fetch workflow by name (no caching)
@@ -10488,11 +10632,7 @@ var WorkflowService = class extends BaseService {
         return workflow2;
       }
     }
-    return this.cached(
-      cacheKeys.workflowById(this.tenantId, id),
-      () => this.fetchWorkflowById(id),
-      cacheTtl.workflows
-    );
+    return this.cachedBy("workflowById", id, () => this.fetchWorkflowById(id));
   }
   /**
    * Internal method to fetch workflow by ID (no caching)
@@ -11699,10 +11839,10 @@ var UserProfileService = class extends BaseService {
    * Results are cached if a CacheAdapter is configured.
    */
   async getProfile(profileId) {
-    return this.cached(
-      cacheKeys.userProfileById(this.tenantId, profileId),
-      () => this.adapter.userProfiles.findById(profileId),
-      cacheTtl.userProfiles
+    return this.cachedBy(
+      "userProfileById",
+      profileId,
+      () => this.adapter.userProfiles.findById(profileId)
     );
   }
   /**
@@ -11725,10 +11865,10 @@ var UserProfileService = class extends BaseService {
    * @returns User profile or null
    */
   async getProfileByAuthId(authId) {
-    return this.cached(
-      cacheKeys.userProfileByAuthId(this.tenantId, authId),
-      () => this.adapter.userProfiles.findByAuthId(authId),
-      cacheTtl.userProfiles
+    return this.cachedBy(
+      "userProfileByAuthId",
+      authId,
+      () => this.adapter.userProfiles.findByAuthId(authId)
     );
   }
   /**
@@ -11860,10 +12000,10 @@ var UserProfileService = class extends BaseService {
    * Automatically uses tenant context from AsyncLocalStorage.
    */
   async getProfileByEmail(email) {
-    return this.cached(
-      cacheKeys.userProfileByEmail(this.tenantId, email),
-      () => this.adapter.userProfiles.findByEmail(email),
-      cacheTtl.userProfiles
+    return this.cachedBy(
+      "userProfileByEmail",
+      email,
+      () => this.adapter.userProfiles.findByEmail(email)
     );
   }
   /**
@@ -12436,7 +12576,18 @@ var GlobalSearchService = class extends BaseService {
     if (!query || query.trim().length === 0) {
       return { results: [], total: 0 };
     }
-    return await this.adapter.objectRecords.globalSearch(query.trim(), {
+    return this.cachedList(
+      "globalSearch",
+      "global",
+      { query: query.trim(), ...options },
+      () => this.executeSearch(query.trim(), options)
+    );
+  }
+  /**
+   * Internal search execution (extracted for caching)
+   */
+  async executeSearch(query, options) {
+    return await this.adapter.objectRecords.globalSearch(query, {
       limit: options?.limit ?? 20,
       offset: options?.offset ?? 0,
       objectNames: options?.objectNames,
@@ -12885,11 +13036,7 @@ var ViewService = class extends BaseService {
    * @returns All views for the object
    */
   async getViewsForObject(objectName) {
-    return this.cached(
-      cacheKeys.viewsByObject(this.tenantId, objectName),
-      () => this.fetchViewsForObject(objectName),
-      cacheTtl.views
-    );
+    return this.cachedBy("viewsByObject", objectName, () => this.fetchViewsForObject(objectName));
   }
   /**
    * Internal method to fetch views for an object (no caching)
@@ -13667,8 +13814,10 @@ export {
   PinCodeService,
   getDefaultPinCodeService,
   initializePinCodeService,
+  hashOptions,
   cacheKeys,
   cacheTtl,
+  defaultTtl,
   NoopCacheAdapter,
   formatRecord,
   formatRecords,
@@ -13745,8 +13894,8 @@ export {
   BaseService,
   BaseRepository,
   SchemaContextAwareRepository,
-  TenantAwareService,
   TenantAwareRepository,
+  TenantAwareService,
   buildAuditChanges,
   ObjectSchemaService,
   AuditService,