create-mercato-app 0.6.6-develop.6388.1.b9b9f5e778 → 0.6.6-develop.6390.1.210bbbc703

package/dist/agentic/guides/module-facts.json

@@ -2,7 +2,7 @@
   "auth": {
     "title": "Authentication & Accounts",
     "description": "User accounts, sessions, roles and password resets.",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "auth:user",
@@ -191,7 +191,7 @@
   "catalog": {
     "title": "Product Catalog",
     "description": "Configurable catalog for products, variants, and pricing used by the sales module.",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "catalog:catalog_option_schema_template",
@@ -405,7 +405,7 @@
   "currencies": {
     "title": "Currencies",
     "description": "Currencies and Exchange rate management",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "currencies:currency",
@@ -489,7 +489,7 @@
   "customer_accounts": {
     "title": "Customer Identity & Portal Authentication",
     "description": "Customer-facing authentication with two-tier identity model and full RBAC.",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "customer_accounts:customer_user",
@@ -729,7 +729,7 @@
   "customers": {
     "title": "Customer Relationship Management",
     "description": "Core CRM capabilities for people, companies, deals, and activities.",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "customers:customer_entity",
@@ -1211,7 +1211,7 @@
   "data_sync": {
     "title": "Data Sync",
     "description": "Streaming data sync hub for import/export integrations.",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "data_sync:sync_run",
@@ -1289,7 +1289,7 @@
   "integrations": {
     "title": "Integrations",
     "description": "Core integration framework — external ID mapping, status badges, and integration registry.",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "integrations:sync_external_id_mapping",
@@ -1365,7 +1365,7 @@
   "sales": {
     "title": "Sales Management",
     "description": "Quoting, ordering, fulfillment, and billing capabilities built on modular pricing and tax pipelines.",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "sales:sales_channel",
@@ -1838,7 +1838,7 @@
   "workflows": {
     "title": "Workflow Engine",
     "description": "Orchestrate business processes with state machines, transitions, and activities",
-    "coreVersion": "0.6.6-develop.6388.1.b9b9f5e778",
+    "coreVersion": "0.6.6-develop.6390.1.210bbbc703",
     "entities": [
       {
         "id": "workflows:workflow_definition",

package/dist/agentic/guides/modules/auth.md

@@ -1,5 +1,5 @@
 # auth — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/catalog.md

@@ -1,5 +1,5 @@
 # catalog — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/currencies.md

@@ -1,5 +1,5 @@
 # currencies — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/customer_accounts.md

@@ -1,5 +1,5 @@
 # customer_accounts — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/customers.md

@@ -1,5 +1,5 @@
 # customers — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/data_sync.md

@@ -1,5 +1,5 @@
 # data_sync — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/integrations.md

@@ -1,5 +1,5 @@
 # integrations — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/sales.md

@@ -1,5 +1,5 @@
 # sales — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/workflows.md

@@ -1,5 +1,5 @@
 # workflows — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.6-develop.6388.1.b9b9f5e778 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.6-develop.6390.1.210bbbc703 — R1 staleness stamp -->
 
 ## Entities
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mercato-app",
-  "version": "0.6.6-develop.6388.1.b9b9f5e778",
+  "version": "0.6.6-develop.6390.1.210bbbc703",
   "type": "module",
   "description": "Create a new Open Mercato application",
   "main": "./dist/index.js",
@@ -22,8 +22,8 @@
     "ts-morph": "^28.0.0"
   },
   "devDependencies": {
-    "@open-mercato/cli": "0.6.6-develop.6388.1.b9b9f5e778",
-    "@open-mercato/shared": "0.6.6-develop.6388.1.b9b9f5e778",
+    "@open-mercato/cli": "0.6.6-develop.6390.1.210bbbc703",
+    "@open-mercato/shared": "0.6.6-develop.6390.1.210bbbc703",
     "@types/node": "^26.0.0",
     "esbuild": "^0.28.1",
     "tsx": "^4.22.4",

package/template/scripts/dev.mjs

@@ -565,6 +565,12 @@ function applyLocalDevBackgroundServiceDefaults(childEnv) {
   ) {
     env.OM_AUTO_SPAWN_WORKERS_LAZY = 'true'
   }
+  if (
+    typeof process.env.OM_AUTO_SPAWN_WORKERS_LAZY_MODE !== 'string'
+    || process.env.OM_AUTO_SPAWN_WORKERS_LAZY_MODE.trim() === ''
+  ) {
+    env.OM_AUTO_SPAWN_WORKERS_LAZY_MODE = 'shared'
+  }
   if (
     typeof process.env.OM_AUTO_SPAWN_SCHEDULER_LAZY !== 'string'
     || process.env.OM_AUTO_SPAWN_SCHEDULER_LAZY.trim() === ''

package/template/src/app/api/[...slug]/route.ts

@@ -16,6 +16,7 @@ import { getCachedRateLimiterService } from '@open-mercato/core/bootstrap'
 import { checkRateLimit, getClientIp, RATE_LIMIT_ERROR_KEY, RATE_LIMIT_ERROR_FALLBACK } from '@open-mercato/shared/lib/ratelimit/helpers'
 import { getGlobalEventBus } from '@open-mercato/shared/modules/events'
 import { applicationLifecycleEvents, type ApplicationLifecycleEventId } from '@open-mercato/shared/lib/runtime/events'
+import { withModuleResourceUsage } from '@open-mercato/shared/lib/modules/resource-usage'
 
 // Ensure all package registrations are initialized for API routes.
 bootstrap()
@@ -39,6 +40,10 @@ type MethodMetadata = {
   requireRoles?: string[]
   requireFeatures?: string[]
   rateLimit?: RateLimitConfig
+  /** Route-declared opt-out from module-resource-usage tracking (e.g. an endpoint that itself
+   * reads/clears that telemetry, so tracking it would perturb the data it just reported). Set
+   * `skipModuleResourceUsageTracking: true` in the route's `metadata` export for the method. */
+  skipModuleResourceUsageTracking?: boolean
 }
 
 type HandlerContext = {
@@ -122,6 +127,9 @@ function extractMethodMetadata(metadata: unknown, method: HttpMethod): MethodMet
       }
     }
   }
+  if (typeof source.skipModuleResourceUsageTracking === 'boolean') {
+    normalized.skipModuleResourceUsageTracking = source.skipModuleResourceUsageTracking
+  }
   return Object.keys(normalized).length > 0 ? normalized : null
 }
 
@@ -410,7 +418,18 @@ async function handleRequest(
 
   try {
     const handlerContext: HandlerContext = { params: match.params, auth }
-    const response = await runWithCacheTenant(auth?.tenantId ?? null, () => handler(req, handlerContext))
+    const runHandler = () => runWithCacheTenant(auth?.tenantId ?? null, () => handler(req, handlerContext))
+    const response = methodMetadata?.skipModuleResourceUsageTracking !== true
+      ? await withModuleResourceUsage(
+        {
+          moduleId: match.route.moduleId,
+          surface: 'api',
+          operation: `${method} ${match.route.path}`,
+          resourceId: `${method} ${match.route.path}`,
+        },
+        runHandler,
+      )
+      : await runHandler()
     const finalResponse = authResolution.status === 'invalid' && response.status === 401
       ? clearStaffAuthCookies(response)
       : response