@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.5

package/dist/esm/core/resources/rmm/canonical-read.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-read.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/canonical-read.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAET,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,uCAAuC,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAM1L,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD,GACA,uCAAuC,GAAG,SAAS,CAmCrD;AAED,wBAAgB,uCAAuC,CACrD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD,GACA,MAAM,GAAG,SAAS,CAuBpB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6BAA6B,EAAE,MAAM,CAAC;IACtC,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAOV;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,WAAW,EAAE,aAAa,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,GAAG,OAAO,EAAE,CAAC;CACxF,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASnC"}
+{"version":3,"file":"canonical-read.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/canonical-read.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAET,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,mEAAmE,CAAC;AACpI,OAAO,KAAK,EAAE,uCAAuC,EAAE,gCAAgC,EAAE,yBAAyB,EAAE,MAAM,+DAA+D,CAAC;AAM1L,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD,GACA,uCAAuC,GAAG,SAAS,CAmCrD;AAED,wBAAgB,uCAAuC,CACrD,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,yBAAyB,EACnC,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CACxD,GACA,MAAM,GAAG,SAAS,CAuBpB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6BAA6B,EAAE,MAAM,CAAC;IACtC,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,OAAO,CAOV;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,WAAW,EAAE,aAAa,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,0CAA0C,EAAE,GAAG,OAAO,EAAE,CAAC;CACxF,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASnC"}

package/dist/esm/core/resources/rmm/canonical-read.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-read.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/canonical-read.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,QAAQ,EACR,kCAAkC,GACnC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,4BAA4B,EAC5B,qCAAqC,GACtC,MAAM,uEAAuE,CAAC;AAC/E,OAAO,EAAE,mDAAmD,EAAE,MAAM,2EAA2E,CAAC;AAGhJ,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC,GAAG,CAAC;AAEpD,MAAM,UAAU,gCAAgC,CAC9C,YAAoB,EACpB,QAAmC,EACnC,OAIC;IAED,MAAM,cAAc,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,cAAc,EAAE,UAAU,IAAI,EAAE,CAAC;IACpD,MAAM,iBAAiB,GAAG,OAAO;QAC/B,CAAC,CAAC,mDAAmD,CAAC;YACpD,cAAc;YACd,UAAU;YACV,aAAa,EAAE,qBAAqB,CAAC,IAAI;YACzC,QAAQ;YACR,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,0BAA0B,EAAE,OAAO,CAAC,0BAA0B;YAC9D,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;SACnD,CAAC;QACF,CAAC,CAAC,qCAAqC,CACrC,UAAU,EACV,qBAAqB,CAAC,IAAI,CAC3B,CAAC;IACJ,IAAI,iBAAiB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACpE,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,qBAAqB,GAAG,4BAA4B,CACxD,UAAU,EACV,qBAAqB,CAAC,IAAI,CAC3B,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CACrB,SAAS,CAAC,kBAAkB,KAAK,IAAI;WAClC,SAAS,CAAC,eAAe,KAAK,IAAI;WAClC,CAAC,SAAS,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CACzD,CAAC,aAAa,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAClD,OAAO,CAAC,0BAA0B,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,KAAK,SAAS;eAC/E,OAAO,CAAC,oBAAoB,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,SAAS,CAC3E,CACF,CACF,CAAC;IACF,OAAO,qBAAqB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,YAAoB,EACpB,QAAmC,EACnC,OAIC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,sBAAsB,CAAC,YAAY,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC;IACnF,MAAM,sBAAsB,GAAG,4BAA4B,CACzD,UAAU,EACV,qBAAqB,CAAC,IAAI,CAC3B,CAAC;IACF,MAAM,aAAa,GAAG,gCAAgC,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAExF,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,kCAAkC,CAAC,mCAAmC,CAAC,aAAa,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,sBAAsB,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,qBAAqB,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CACxE,SAAS,CAAC,kBAAkB,KAAK,IAAI;WAClC,SAAS,CAAC,eAAe,KAAK,IAAI,CACtC,CAAC;IACF,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,kCAAkC,CAAC,mCAAmC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAI3C;IACC,8EAA8E;IAC9E,qEAAqE;IACrE,wEAAwE;IACxE,wDAAwD;IACxD,OAAO,MAAM,CAAC,sBAAsB,KAAK,MAAM,CAAC,6BAA6B;WACxE,MAAM,CAAC,QAAQ,KAAK,uBAAuB,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAK7C;IACC,2EAA2E;IAC3E,qEAAqE;IACrE,0DAA0D;IAC1D,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,oBAAoB,EAAE;QACrD,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,2BAA2B,EAAE,MAAM,CAAC,2BAAuF;QAC3H,QAAQ,EAAE,uBAAuB;KAClC,CAAqC,CAAC;AACzC,CAAC","sourcesContent":["import {\n  CoreResourceOperation,\n  DataMode,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FrontendResourceConfiguration_Operation, FrontendResourceOperationContext, FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n  getOperationsForCoreSemantic,\n  pickPreferredOperationForCoreSemantic,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport type { DoOperationFn } from './HttpTransportAdapter';\n\nexport const CANONICAL_RMM_DATA_MODE = DataMode.RAW;\n\nexport function resolveCanonicalRMMReadOperation(\n  resourceType: string,\n  registry: FrontendResourcesRegistry,\n  options?: {\n    hasResourceId?: boolean;\n    contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n    contextualParameters?: Record<string, string | number>;\n  },\n): FrontendResourceConfiguration_Operation | undefined {\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n  const operations = resourceConfig?.operations ?? [];\n  const selectedOperation = options\n    ? pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations,\n      coreOperation: CoreResourceOperation.READ,\n      registry,\n      hasResourceId: options.hasResourceId,\n      contextResourceIdentifiers: options.contextResourceIdentifiers,\n      contextualParameters: options.contextualParameters,\n    })\n    : pickPreferredOperationForCoreSemantic(\n      operations,\n      CoreResourceOperation.READ,\n    );\n  if (selectedOperation || !options || options.hasResourceId === true) {\n    return selectedOperation;\n  }\n\n  const contextReadCandidates = getOperationsForCoreSemantic(\n    operations,\n    CoreResourceOperation.READ,\n  ).filter((operation) =>\n    operation.isOperationDefault !== true\n    && operation.isBulkOperation !== true\n    && (operation.initiatorInfos ?? []).some((initiatorInfo) =>\n      (initiatorInfo.parameters ?? []).some((parameter) =>\n        options.contextResourceIdentifiers?.[String(parameter.resourceType)] !== undefined\n        || options.contextualParameters?.[parameter.fieldIdentifier] !== undefined\n      )\n    )\n  );\n  return contextReadCandidates.length === 1 ? contextReadCandidates[0] : undefined;\n}\n\nexport function resolveCanonicalRMMReadOperationPathKey(\n  resourceType: string,\n  registry: FrontendResourcesRegistry,\n  options?: {\n    hasResourceId?: boolean;\n    contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n    contextualParameters?: Record<string, string | number>;\n  },\n): string | undefined {\n  const operations = registry.resourceConfigurations[resourceType]?.operations ?? [];\n  const semanticReadOperations = getOperationsForCoreSemantic(\n    operations,\n    CoreResourceOperation.READ,\n  );\n  const readOperation = resolveCanonicalRMMReadOperation(resourceType, registry, options);\n\n  if (readOperation) {\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(readOperation);\n  }\n  if (semanticReadOperations.length === 0 || options) {\n    return undefined;\n  }\n\n  const defaultReadOperations = semanticReadOperations.filter((operation) =>\n    operation.isOperationDefault === true\n    && operation.isBulkOperation !== true\n  );\n  if (defaultReadOperations.length !== 1) {\n    return undefined;\n  }\n  return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(defaultReadOperations[0]);\n}\n\nexport function canSeedRMMFromLoadedPayload(params: {\n  loadedOperationPathKey: string;\n  canonicalReadOperationPathKey: string;\n  dataMode: DataMode;\n}): boolean {\n  // Initial payloads are only trusted as confirmed RMM seed data when they came\n  // from the same canonical READ surface the RMM would use for its own\n  // authoritative rereads. Other loaded data may be valid UI data but not\n  // strong enough to become optimistic-sync ground truth.\n  return params.loadedOperationPathKey === params.canonicalReadOperationPathKey\n    && params.dataMode === CANONICAL_RMM_DATA_MODE;\n}\n\nexport async function performCanonicalRMMRead(params: {\n  doOperation: DoOperationFn;\n  readOperationPathKey: string;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[] | unknown[];\n}): Promise<Record<string, unknown>> {\n  // All authoritative frontend rereads share one contract: use the preferred\n  // READ operation in RAW mode, whether the caller is initial seeding,\n  // websocket recovery, or mutation read-back verification.\n  return params.doOperation(params.readOperationPathKey, {\n    contextualParameters: params.contextualParameters,\n    parentResourcesRequirements: params.parentResourcesRequirements as FrontendResource_ParentResourceRequirement[] | undefined,\n    dataMode: CANONICAL_RMM_DATA_MODE,\n  }) as Promise<Record<string, unknown>>;\n}\n"]}
+{"version":3,"file":"canonical-read.frontend.utils.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/canonical-read.frontend.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  CoreResourceOperation,\n  DataMode,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { FrontendResource_ParentResourceRequirement } from '~wildo-frontend-lib/core/resources/resource-path.frontend.schemas';\nimport type { FrontendResourceConfiguration_Operation, FrontendResourceOperationContext, FrontendResourcesRegistry } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport {\n  getOperationsForCoreSemantic,\n  pickPreferredOperationForCoreSemantic,\n} from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport type { DoOperationFn } from './HttpTransportAdapter';\n\nexport const CANONICAL_RMM_DATA_MODE = DataMode.RAW;\n\nexport function resolveCanonicalRMMReadOperation(\n  resourceType: string,\n  registry: FrontendResourcesRegistry,\n  options?: {\n    hasResourceId?: boolean;\n    contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n    contextualParameters?: Record<string, string | number>;\n  },\n): FrontendResourceConfiguration_Operation | undefined {\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n  const operations = resourceConfig?.operations ?? [];\n  const selectedOperation = options\n    ? pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations,\n      coreOperation: CoreResourceOperation.READ,\n      registry,\n      hasResourceId: options.hasResourceId,\n      contextResourceIdentifiers: options.contextResourceIdentifiers,\n      contextualParameters: options.contextualParameters,\n    })\n    : pickPreferredOperationForCoreSemantic(\n      operations,\n      CoreResourceOperation.READ,\n    );\n  if (selectedOperation || !options || options.hasResourceId === true) {\n    return selectedOperation;\n  }\n\n  const contextReadCandidates = getOperationsForCoreSemantic(\n    operations,\n    CoreResourceOperation.READ,\n  ).filter((operation) =>\n    operation.isOperationDefault !== true\n    && operation.isBulkOperation !== true\n    && (operation.initiatorInfos ?? []).some((initiatorInfo) =>\n      (initiatorInfo.parameters ?? []).some((parameter) =>\n        options.contextResourceIdentifiers?.[String(parameter.resourceType)] !== undefined\n        || options.contextualParameters?.[parameter.fieldIdentifier] !== undefined\n      )\n    )\n  );\n  return contextReadCandidates.length === 1 ? contextReadCandidates[0] : undefined;\n}\n\nexport function resolveCanonicalRMMReadOperationPathKey(\n  resourceType: string,\n  registry: FrontendResourcesRegistry,\n  options?: {\n    hasResourceId?: boolean;\n    contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n    contextualParameters?: Record<string, string | number>;\n  },\n): string | undefined {\n  const operations = registry.resourceConfigurations[resourceType]?.operations ?? [];\n  const semanticReadOperations = getOperationsForCoreSemantic(\n    operations,\n    CoreResourceOperation.READ,\n  );\n  const readOperation = resolveCanonicalRMMReadOperation(resourceType, registry, options);\n\n  if (readOperation) {\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(readOperation);\n  }\n  if (semanticReadOperations.length === 0 || options) {\n    return undefined;\n  }\n\n  const defaultReadOperations = semanticReadOperations.filter((operation) =>\n    operation.isOperationDefault === true\n    && operation.isBulkOperation !== true\n  );\n  if (defaultReadOperations.length !== 1) {\n    return undefined;\n  }\n  return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(defaultReadOperations[0]);\n}\n\nexport function canSeedRMMFromLoadedPayload(params: {\n  loadedOperationPathKey: string;\n  canonicalReadOperationPathKey: string;\n  dataMode: DataMode;\n}): boolean {\n  // Initial payloads are only trusted as confirmed RMM seed data when they came\n  // from the same canonical READ surface the RMM would use for its own\n  // authoritative rereads. Other loaded data may be valid UI data but not\n  // strong enough to become optimistic-sync ground truth.\n  return params.loadedOperationPathKey === params.canonicalReadOperationPathKey\n    && params.dataMode === CANONICAL_RMM_DATA_MODE;\n}\n\nexport async function performCanonicalRMMRead(params: {\n  doOperation: DoOperationFn;\n  readOperationPathKey: string;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: FrontendResource_ParentResourceRequirement[] | unknown[];\n}): Promise<Record<string, unknown>> {\n  // All authoritative frontend rereads share one contract: use the preferred\n  // READ operation in RAW mode, whether the caller is initial seeding,\n  // websocket recovery, or mutation read-back verification.\n  return params.doOperation(params.readOperationPathKey, {\n    contextualParameters: params.contextualParameters,\n    parentResourcesRequirements: params.parentResourcesRequirements as FrontendResource_ParentResourceRequirement[] | undefined,\n    dataMode: CANONICAL_RMM_DATA_MODE,\n  }) as Promise<Record<string, unknown>>;\n}\n"]}

package/dist/esm/core/resources/rmm/field-path.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-path.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/field-path.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAInF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAYtE"}
+{"version":3,"file":"field-path.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/field-path.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAInF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAYtE"}

package/dist/esm/core/resources/rmm/field-path.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-path.utils.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/field-path.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,SAAiB;IACxE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC7D,OAAO,mBAAmB,KAAK,gBAAgB,IAAI,mBAAmB,CAAC,UAAU,CAAC,gBAAgB,GAAG,GAAG,CAAC,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAa;IAC9D,OAAO,wBAAwB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,IAAY;IAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAU,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE;QACzF,IAAI,YAAY,IAAI,IAAI,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC7D,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAQ,YAAwC,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,EAAE,KAAK,CAAC,CAAC;AACZ,CAAC","sourcesContent":["/**\n * RMM field-path helpers — shared by display/event matching and (eventually) queue coalescing.\n *\n * Strict segment boundary: `items.10` is **not** under `items.1` (requires `.` after prefix).\n */\n\nexport function rmmNormalizeFieldPath(path: string): string {\n  return path.replace(/\\[(\\d+)\\]/g, '.$1');\n}\n\nexport function rmmFieldPathIsDescendant(prefix: string, fieldPath: string): boolean {\n  const normalizedPrefix = rmmNormalizeFieldPath(prefix);\n  const normalizedFieldPath = rmmNormalizeFieldPath(fieldPath);\n  return normalizedFieldPath === normalizedPrefix || normalizedFieldPath.startsWith(normalizedPrefix + '.');\n}\n\nexport function rmmFieldPathsOverlap(left: string, right: string): boolean {\n  return rmmFieldPathIsDescendant(left, right) || rmmFieldPathIsDescendant(right, left);\n}\n\nexport function rmmReadPathValue(value: unknown, path: string): unknown {\n  if (!path) {\n    return value;\n  }\n\n  const normalizedPath = rmmNormalizeFieldPath(path);\n  return normalizedPath.split('.').filter(Boolean).reduce<unknown>((currentValue, segment) => {\n    if (currentValue == null || typeof currentValue !== 'object') {\n      return undefined;\n    }\n    return (currentValue as Record<string, unknown>)[segment];\n  }, value);\n}\n"]}
+{"version":3,"file":"field-path.utils.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/field-path.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,SAAiB;IACxE,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC7D,OAAO,mBAAmB,KAAK,gBAAgB,IAAI,mBAAmB,CAAC,UAAU,CAAC,gBAAgB,GAAG,GAAG,CAAC,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAa;IAC9D,OAAO,wBAAwB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc,EAAE,IAAY;IAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAU,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE;QACzF,IAAI,YAAY,IAAI,IAAI,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YAC7D,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAQ,YAAwC,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,EAAE,KAAK,CAAC,CAAC;AACZ,CAAC","sourcesContent":["/**\n * RMM field-path helpers — shared by display/event matching and (eventually) queue coalescing.\n *\n * Strict segment boundary: `items.10` is **not** under `items.1` (requires `.` after prefix).\n */\n\nexport function rmmNormalizeFieldPath(path: string): string {\n  return path.replace(/\\[(\\d+)\\]/g, '.$1');\n}\n\nexport function rmmFieldPathIsDescendant(prefix: string, fieldPath: string): boolean {\n  const normalizedPrefix = rmmNormalizeFieldPath(prefix);\n  const normalizedFieldPath = rmmNormalizeFieldPath(fieldPath);\n  return normalizedFieldPath === normalizedPrefix || normalizedFieldPath.startsWith(normalizedPrefix + '.');\n}\n\nexport function rmmFieldPathsOverlap(left: string, right: string): boolean {\n  return rmmFieldPathIsDescendant(left, right) || rmmFieldPathIsDescendant(right, left);\n}\n\nexport function rmmReadPathValue(value: unknown, path: string): unknown {\n  if (!path) {\n    return value;\n  }\n\n  const normalizedPath = rmmNormalizeFieldPath(path);\n  return normalizedPath.split('.').filter(Boolean).reduce<unknown>((currentValue, segment) => {\n    if (currentValue == null || typeof currentValue !== 'object') {\n      return undefined;\n    }\n    return (currentValue as Record<string, unknown>)[segment];\n  }, value);\n}\n"]}

package/dist/esm/core/resources/rmm/mutation-error-report.utils.d.ts

@@ -0,0 +1,18 @@
+import type { MutationError } from '../../../core/resources/rmm/types';
+/**
+ * The `Error` a surface reports or throws for a failed mutation: the transport failure ITSELF when there
+ * is one, and a message-only `Error` only when there is not.
+ *
+ * `MutationError.type` is a coarse retry classification, and `message` is prose. What says WHY the
+ * server refused — its `customMessageReference`, its error type, its declared refusal code — lives on
+ * the HTTP client's error, which the transport keeps on `cause` (with `wildoError` attached). Every
+ * surface that rebuilt `new Error(mutationError.message)` discarded all of it, so a save refused for a
+ * stated reason reached the person as "Unexpected error", classified as an uncaught exception. Measured
+ * on a directory-managed unit's rename, which the server refused with
+ * `409 organization_unit_directory_managed` (#1447).
+ *
+ * One function for every site, so the next surface that reports a mutation failure cannot drop the
+ * reference by rebuilding the error by hand.
+ */
+export declare function mutationErrorForReport(error: MutationError | undefined, fallbackMessage: string): Error;
+//# sourceMappingURL=mutation-error-report.utils.d.ts.map

package/dist/esm/core/resources/rmm/mutation-error-report.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-error-report.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/mutation-error-report.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,CAGvG"}

package/dist/esm/core/resources/rmm/mutation-error-report.utils.js

@@ -0,0 +1,21 @@
+/**
+ * The `Error` a surface reports or throws for a failed mutation: the transport failure ITSELF when there
+ * is one, and a message-only `Error` only when there is not.
+ *
+ * `MutationError.type` is a coarse retry classification, and `message` is prose. What says WHY the
+ * server refused — its `customMessageReference`, its error type, its declared refusal code — lives on
+ * the HTTP client's error, which the transport keeps on `cause` (with `wildoError` attached). Every
+ * surface that rebuilt `new Error(mutationError.message)` discarded all of it, so a save refused for a
+ * stated reason reached the person as "Unexpected error", classified as an uncaught exception. Measured
+ * on a directory-managed unit's rename, which the server refused with
+ * `409 organization_unit_directory_managed` (#1447).
+ *
+ * One function for every site, so the next surface that reports a mutation failure cannot drop the
+ * reference by rebuilding the error by hand.
+ */
+export function mutationErrorForReport(error, fallbackMessage) {
+    if (error?.cause instanceof Error)
+        return error.cause;
+    return new Error(error?.message ?? fallbackMessage);
+}
+//# sourceMappingURL=mutation-error-report.utils.js.map

package/dist/esm/core/resources/rmm/mutation-error-report.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-error-report.utils.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/mutation-error-report.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAgC,EAAE,eAAuB;IAC9F,IAAI,KAAK,EAAE,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACtD,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import type { MutationError } from '~wildo-frontend-lib/core/resources/rmm/types';\n\n/**\n * The `Error` a surface reports or throws for a failed mutation: the transport failure ITSELF when there\n * is one, and a message-only `Error` only when there is not.\n *\n * `MutationError.type` is a coarse retry classification, and `message` is prose. What says WHY the\n * server refused — its `customMessageReference`, its error type, its declared refusal code — lives on\n * the HTTP client's error, which the transport keeps on `cause` (with `wildoError` attached). Every\n * surface that rebuilt `new Error(mutationError.message)` discarded all of it, so a save refused for a\n * stated reason reached the person as \"Unexpected error\", classified as an uncaught exception. Measured\n * on a directory-managed unit's rename, which the server refused with\n * `409 organization_unit_directory_managed` (#1447).\n *\n * One function for every site, so the next surface that reports a mutation failure cannot drop the\n * reference by rebuilding the error by hand.\n */\nexport function mutationErrorForReport(error: MutationError | undefined, fallbackMessage: string): Error {\n  if (error?.cause instanceof Error) return error.cause;\n  return new Error(error?.message ?? fallbackMessage);\n}\n"]}

package/dist/esm/core/resources/rmm/rmm-constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rmm-constants.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/rmm-constants.ts"],"names":[],"mappings":"AACA,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,gDAAgD;AAChD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,iDAAiD;AACjD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,uBAA0B,CAAC;AAElE,yCAAyC;AACzC,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAG/C,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,4DAA4D;AAC5D,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,oCAAoC;AACpC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAG9C,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,oDAAoD;AACpD,eAAO,MAAM,kCAAkC,QAAiB,CAAC;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,6BAA6B,QAAiB,CAAC"}
+{"version":3,"file":"rmm-constants.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/rmm-constants.ts"],"names":[],"mappings":"AACA,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,gDAAgD;AAChD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,iDAAiD;AACjD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,uBAA0B,CAAC;AAElE,yCAAyC;AACzC,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAG/C,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,4DAA4D;AAC5D,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,oCAAoC;AACpC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAG9C,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,oDAAoD;AACpD,eAAO,MAAM,kCAAkC,QAAiB,CAAC;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,6BAA6B,QAAiB,CAAC"}

package/dist/esm/core/resources/rmm/rmm-constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"rmm-constants.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/rmm-constants.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,iDAAiD;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,6CAA6C;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;AAElE,yCAAyC;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAE/C,qEAAqE;AACrE,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,oCAAoC;AACpC,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C,oEAAoE;AACpE,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,oDAAoD;AACpD,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC","sourcesContent":["// ── Mutation queue & backpressure ──────────────────────────────────\n/** Max mutation queue depth before LOW-priority mutations are rejected */\nexport const RMM_MAX_QUEUE_DEPTH = 5;\n\n/** Soft timeout — warning event emitted (ms) */\nexport const RMM_SOFT_TIMEOUT_MS = 15_000;\n\n/** Hard timeout — mutation force-aborted (ms) */\nexport const RMM_HARD_TIMEOUT_MS = 30_000;\n\n/** Retry delays for transient errors (ms) */\nexport const RMM_TRANSIENT_RETRY_DELAYS = [1_000, 3_000] as const;\n\n/** Retry delay for server errors (ms) */\nexport const RMM_SERVER_RETRY_DELAY_MS = 2_000;\n\n// ── Registry ──────────────────────────────────────────────────────\n/** Delay before destroying an unreferenced RMM instance (ms) — Strict Mode safe */\nexport const RMM_REGISTRY_DESTROY_DELAY_MS = 100;\n\n/** Registry capacity warning threshold (fraction of max) */\nexport const RMM_REGISTRY_CAPACITY_WARNING = 0.8;\n\n/** Max RMM instances in registry */\nexport const RMM_REGISTRY_MAX_INSTANCES = 200;\n\n// ── Clock sync (CRDT) ────────────────────────────────────────────\n/** Number of samples to collect before calibrating clock offset */\nexport const CLOCK_SYNC_SAMPLE_COUNT = 5;\n\n/** Interval between periodic recalibrations (ms) */\nexport const CLOCK_SYNC_RECALIBRATE_INTERVAL_MS = 5 * 60 * 1_000;\n\n/** Threshold for considering a calibration stale on visibilitychange (ms) */\nexport const CLOCK_SYNC_STALE_THRESHOLD_MS = 5 * 60 * 1_000;\n"]}
+{"version":3,"file":"rmm-constants.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/rmm-constants.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,iDAAiD;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,6CAA6C;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAAK,EAAE,KAAK,CAAU,CAAC;AAElE,yCAAyC;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAE/C,qEAAqE;AACrE,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,oCAAoC;AACpC,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C,oEAAoE;AACpE,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,oDAAoD;AACpD,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC","sourcesContent":["// ── Mutation queue & backpressure ──────────────────────────────────\n/** Max mutation queue depth before LOW-priority mutations are rejected */\nexport const RMM_MAX_QUEUE_DEPTH = 5;\n\n/** Soft timeout — warning event emitted (ms) */\nexport const RMM_SOFT_TIMEOUT_MS = 15_000;\n\n/** Hard timeout — mutation force-aborted (ms) */\nexport const RMM_HARD_TIMEOUT_MS = 30_000;\n\n/** Retry delays for transient errors (ms) */\nexport const RMM_TRANSIENT_RETRY_DELAYS = [1_000, 3_000] as const;\n\n/** Retry delay for server errors (ms) */\nexport const RMM_SERVER_RETRY_DELAY_MS = 2_000;\n\n// ── Registry ──────────────────────────────────────────────────────\n/** Delay before destroying an unreferenced RMM instance (ms) — Strict Mode safe */\nexport const RMM_REGISTRY_DESTROY_DELAY_MS = 100;\n\n/** Registry capacity warning threshold (fraction of max) */\nexport const RMM_REGISTRY_CAPACITY_WARNING = 0.8;\n\n/** Max RMM instances in registry */\nexport const RMM_REGISTRY_MAX_INSTANCES = 200;\n\n// ── Clock sync (CRDT) ────────────────────────────────────────────\n/** Number of samples to collect before calibrating clock offset */\nexport const CLOCK_SYNC_SAMPLE_COUNT = 5;\n\n/** Interval between periodic recalibrations (ms) */\nexport const CLOCK_SYNC_RECALIBRATE_INTERVAL_MS = 5 * 60 * 1_000;\n\n/** Threshold for considering a calibration stale on visibilitychange (ms) */\nexport const CLOCK_SYNC_STALE_THRESHOLD_MS = 5 * 60 * 1_000;\n"]}

package/dist/esm/core/resources/rmm/rmm-noop-snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rmm-noop-snapshot.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/rmm-noop-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,CAAC,MAAM,IAAI,CAAa,CAAC;AAC3D,eAAO,MAAM,aAAa,EAAE,WAAgD,CAAC;AAC7E,eAAO,MAAM,iBAAiB,QAAO,WAA4B,CAAC"}
+{"version":3,"file":"rmm-noop-snapshot.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/rmm-noop-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAO,CAAC,MAAM,IAAI,CAAa,CAAC;AAC3D,eAAO,MAAM,aAAa,EAAE,WAAgD,CAAC;AAC7E,eAAO,MAAM,iBAAiB,QAAO,WAA4B,CAAC"}

package/dist/esm/core/resources/rmm/rmm-noop-snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"rmm-noop-snapshot.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/rmm-noop-snapshot.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAiB,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAgB,EAAE,SAAS,EAAE,IAAI,EAAiB,CAAC;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAgB,EAAE,CAAC,aAAa,CAAC","sourcesContent":["import type { RMMSnapshot } from './types';\n\n/**\n * Stable references for useSyncExternalStore when no RMM instance is available.\n * Must be module-level constants for referential stability (React strict-mode safe).\n */\nexport const NOOP_SUBSCRIBE = (): (() => void) => () => {};\nexport const NOOP_SNAPSHOT: RMMSnapshot = { lastEvent: null } as RMMSnapshot;\nexport const NOOP_GET_SNAPSHOT = (): RMMSnapshot => NOOP_SNAPSHOT;\n"]}
+{"version":3,"file":"rmm-noop-snapshot.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/rmm-noop-snapshot.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAiB,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,aAAa,GAAgB,EAAE,SAAS,EAAE,IAAI,EAAiB,CAAC;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAgB,EAAE,CAAC,aAAa,CAAC","sourcesContent":["import type { RMMSnapshot } from './types';\n\n/**\n * Stable references for useSyncExternalStore when no RMM instance is available.\n * Must be module-level constants for referential stability (React strict-mode safe).\n */\nexport const NOOP_SUBSCRIBE = (): (() => void) => () => {};\nexport const NOOP_SNAPSHOT: RMMSnapshot = { lastEvent: null } as RMMSnapshot;\nexport const NOOP_GET_SNAPSHOT = (): RMMSnapshot => NOOP_SNAPSHOT;\n"]}

package/dist/esm/core/resources/rmm/types.d.ts

@@ -170,6 +170,13 @@ export interface MutationError {
         submittedValues: Record<string, unknown>;
     };
     message?: string;
+    /**
+     * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's
+     * reference, error type and user guidance. `type` is a coarse RETRY classification (every non-conflict 4xx
+     * is `VALIDATION`), so a surface that shows the failure to a person resolves THIS through
+     * `useUserFacingErrorMessage()` rather than `type` or `message`.
+     */
+    cause?: unknown;
 }
 export interface ActiveMutation {
     entry: MutationQueueEntry;
@@ -219,6 +226,13 @@ export interface OperationResult {
         message?: string;
         /** Populated when the backend supplies authoritative state on version conflict (409). */
         conflictDetails?: MutationError['conflictDetails'];
+        /**
+         * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's
+         * reference, error type and user guidance. `type` is a coarse RETRY classification (every non-conflict 4xx
+         * is `VALIDATION`), so a surface that shows the failure to a person resolves THIS through
+         * `useUserFacingErrorMessage()` rather than `type` or `message`.
+         */
+        cause?: unknown;
     };
 }
 export declare class MutationCancelledError extends Error {

package/dist/esm/core/resources/rmm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED,oBAAY,YAAY;IACtB,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;CACtC;AAED,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,YAAY,iBAAiB;IAC7B,MAAM,WAAW;CAClB;AAED,oBAAY,iBAAiB;IAC3B,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAED,oBAAY,qBAAqB;IAC/B,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,oBAAY,gBAAgB;IAC1B,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;CACpC;AAED,oBAAY,cAAc;IACxB,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;CAChC;AAED,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,oBAAY,gBAAgB;IAC1B,GAAG,IAAI;IACP,MAAM,IAAI;IACV,IAAI,IAAI;IACR,SAAS,IAAI;CACd;AAID;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,YAAY,CAAC,eAAe,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAClG;IAAE,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACnM;IACE,IAAI,EAAE,YAAY,CAAC,cAAc,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACnD,EAAE,EAAE,MAAM,CAAC;CACZ,GACD;IAAE,IAAI,EAAE,YAAY,CAAC,gBAAgB,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAIpG,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC5B;AAID,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5C;AAID,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACvD,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,eAAe,CAAC,EAAE;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC1C,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,eAAe,EAAE,eAAe,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAID,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,yFAAyF;QACzF,eAAe,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;KACpD,CAAC;CACH;AAID,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAkB,IAAI,4BAA4B;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;gBAErB,MAAM,CAAC,EAAE,cAAc;CAIpC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAkB,IAAI,0BAA0B;;CAKjD;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,+BAA+B;;CAKtD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/resources/rmm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAKhF,gBAAgB;AAEhB,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,2BAAe,CAAA;IACf,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;AACrB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,mDAAmC,CAAA;IACnC,+CAA+B,CAAA;IAC/B,iDAAiC,CAAA;IACjC,qDAAqC,CAAA;AACvC,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,CAAN,IAAY,YAQX;AARD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,iCAAiB,CAAA;AACnB,CAAC,EARW,YAAY,KAAZ,YAAY,QAQvB;AAED,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,yCAAmB,CAAA;IACnB,mDAA6B,CAAA;IAC7B,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;IACrB,4CAAuB,CAAA;IACvB,4CAAuB,CAAA;IACvB,sCAAiB,CAAA;IACjB,oCAAe,CAAA;AACjB,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED,MAAM,CAAN,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,4CAAmB,CAAA;IACnB,wCAAe,CAAA;AACjB,CAAC,EAHW,qBAAqB,KAArB,qBAAqB,QAGhC;AAED,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,mDAA+B,CAAA;IAC/B,uDAAmC,CAAA;AACrC,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,uDAAqC,CAAA;IACrC,iDAA+B,CAAA;AACjC,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,mCAAiB,CAAA;AACnB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,qDAAO,CAAA;IACP,2DAAU,CAAA;IACV,uDAAQ,CAAA;IACR,iEAAa,CAAA;AACf,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAoLD,wBAAwB;AAExB,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,IAAI,GAAG,wBAAwB,CAAC;IACzC,MAAM,CAAkB;IAEjC,YAAY,MAAuB;QACjC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3B,IAAI,GAAG,sBAAsB,CAAC;IAEhD;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChC,IAAI,GAAG,2BAA2B,CAAC;IAErD;QACE,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACtD,CAAC;CACF","sourcesContent":["// =============================================================================\n// RMM Module — Type Definitions\n// =============================================================================\n\nimport type { DataMode, FieldMetaEntry, FieldMetaMap } from '@wildo-ai/saas-models';\nimport type { CrdtResolutionWinner } from '@wildo-ai/saas-models';\n\n// --- Enums ---\n\nexport enum RMMState {\n  IDLE = 'IDLE',\n  QUEUED = 'QUEUED',\n  SAVING = 'SAVING',\n  ERROR = 'ERROR',\n  CONFLICT = 'CONFLICT',\n  DELETED = 'DELETED',\n}\n\nexport enum RMMEventType {\n  MUTATION_RESULT = 'mutation_result',\n  REMOTE_UPDATE = 'remote_update',\n  CONFLICT_RESET = 'conflict_reset',\n  RESOURCE_DELETED = 'resource_deleted',\n}\n\nexport enum MutationType {\n  AUTOSAVE = 'autosave',\n  SUBMIT = 'submit',\n  DRAFT = 'draft',\n  PUBLISH = 'publish',\n  SECTION = 'section',\n  INLINE = 'inline',\n  CUSTOM = 'custom',\n}\n\nexport enum MutationSourceType {\n  FORM = 'form',\n  DISPLAY = 'display',\n  ORCHESTRATOR = 'orchestrator',\n  CUSTOM = 'custom',\n}\n\nexport enum MutationErrorType {\n  VALIDATION = 'validation',\n  CONFLICT = 'conflict',\n  NOT_FOUND = 'not_found',\n  TRANSIENT = 'transient',\n  SERVER = 'server',\n  ABORT = 'abort',\n}\n\nexport enum OperationResultStatus {\n  SUCCESS = 'success',\n  ERROR = 'error',\n}\n\nexport enum ConflictStrategy {\n  ACCEPT_REMOTE = 'accept-remote',\n  LAST_WRITE_WINS = 'last-write-wins',\n}\n\nexport enum ConflictReason {\n  VERSION_CONFLICT = 'version_conflict',\n  REMOTE_UPDATE = 'remote_update',\n}\n\nexport enum DeletionReason {\n  LOCAL = 'local',\n  REMOTE = 'remote',\n}\n\nexport enum MutationPriority {\n  LOW = 0,\n  NORMAL = 1,\n  HIGH = 2,\n  IMMEDIATE = 3,\n}\n\n// --- Events (Declarative Event Model §2.6) ---\n\n/**\n * Events set on `_lastEvent` to drive consumer side effects via `useEffect`.\n * Each event carries a monotonic `id` for dedup: `useEffect([snapshot.lastEvent?.id])`.\n */\nexport type RMMEvent =\n  | { type: RMMEventType.MUTATION_RESULT; result: MutationResult; source: MutationSource; id: number }\n  | { type: RMMEventType.REMOTE_UPDATE; changedFields: string[]; mergedFields: string[]; version: number; initiatorUserId: string; crdtResolutions?: Record<string, CrdtResolutionWinner>; id: number }\n  | {\n      type: RMMEventType.CONFLICT_RESET;\n      discardedFields: string[];\n      reason: ConflictReason;\n      currentData: Record<string, unknown>;\n      currentVersion: number;\n      conflictDetails?: MutationError['conflictDetails'];\n      id: number;\n    }\n  | { type: RMMEventType.RESOURCE_DELETED; reason: DeletionReason; deletedBy?: string; id: number };\n\n// --- Snapshot (for useSyncExternalStore) ---\n\nexport interface RMMSnapshot {\n  state: RMMState;\n  version: number | null;\n  confirmedData: Record<string, unknown> | null;\n  optimisticData: Record<string, unknown> | null;\n  pendingFieldNames: string[];\n  pendingFieldValues: Readonly<Record<string, unknown>>;\n  isSaving: boolean;\n  isDeleted: boolean;\n  hasUnsavedChanges: boolean;\n  error: MutationError | null;\n  queueDepth: number;\n  lastEvent: RMMEvent | null;\n}\n\n// --- Config ---\n\nexport interface ResourceMutationManagerConfig {\n  resourceType: string;\n  resourceId: string | null;\n  transportAdapter: TransportAdapter;\n  conflictPolicy: ConflictPolicy;\n  currentUserId: string;\n  contextResourceIdentifiers?: Record<string, string>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  resourceSchema?: unknown;\n  /** Operation path key for doOperation() routing. Falls back to resourceType if not provided. */\n  operationPathKey?: string;\n  /** Optional READ path used when custom mutations need an authoritative refresh. */\n  readOperationPathKey?: string;\n  /**\n   * Optional backpressure overrides (tests, slow networks). Defaults match\n   * `ResourceMutationManager` internal `DEFAULT_BACKPRESSURE`. Only keys you set\n   * are applied; omitted keys keep defaults (explicit `undefined` does not zero timers).\n   *\n   * With `useResourceMutationManager`, config is captured on first `getOrCreate` for\n   * the registry key — changing `backpressure` on a later render has no effect.\n   */\n  backpressure?: Partial<BackpressureConfig>;\n}\n\n// --- Mutation Types ---\n\nexport interface MutationQueueEntry {\n  id: string;\n  type: MutationType;\n  fields: Record<string, unknown>;\n  priority: MutationPriority;\n  source: MutationSource;\n  resolve: (result: MutationResult) => void;\n  reject: (error: Error) => void;\n  signal?: AbortSignal;\n  transportOverride?: MutationTransportOverride;\n}\n\nexport interface MutationSource {\n  type: MutationSourceType;\n  subscriberId: string;\n}\n\nexport interface MutationTransportOverride {\n  operationPathKey?: string;\n  contextualParameters?: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  requestData?: Record<string, unknown>;\n  readBackOnSuccess?: boolean;\n}\n\nexport interface MutationResult {\n  success: boolean;\n  savedFields?: string[];\n  newVersion?: number;\n  responseData?: Record<string, unknown>;\n  error?: MutationError;\n  retriesRemaining?: number;\n}\n\nexport interface MutationError {\n  type: MutationErrorType;\n  status?: number;\n  validationErrors?: Record<string, unknown>;\n  conflictDetails?: {\n    currentVersion: number;\n    expectedVersion: number;\n    conflictingFields: string[];\n    currentValues: Record<string, unknown>;\n    submittedValues: Record<string, unknown>;\n  };\n  message?: string;\n}\n\nexport interface ActiveMutation {\n  entry: MutationQueueEntry;\n  savingFields: Record<string, unknown>;\n  abortController: AbortController;\n  retryCount: number;\n}\n\n// --- Conflict + CRDT Types ---\n\nexport interface ConflictPolicy {\n  strategy: ConflictStrategy;\n}\n\nexport interface DeferredSelfEvent {\n  changedFields: Record<string, unknown>;\n  version: number;\n  initiatorUserId: string;\n  fieldMeta?: Record<string, FieldMetaEntry>;\n}\n\nexport interface CRDTFieldTimestamps {\n  [fieldPath: string]: number;\n}\n\n// --- Backpressure ---\n\nexport interface BackpressureConfig {\n  maxQueueDepth: number;\n  softTimeoutMs: number;\n  hardTimeoutMs: number;\n}\n\n// --- Transport ---\n\nexport interface TransportAdapter {\n  execute(descriptor: OperationDescriptor): Promise<OperationResult>;\n}\n\nexport interface OperationDescriptor {\n  operationPathKey: string;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  dataMode?: DataMode;\n  requestData?: Record<string, unknown>;\n  expectedVersion?: number | null;\n  signal?: AbortSignal;\n  fieldTimestamps?: CRDTFieldTimestamps;\n}\n\nexport interface OperationResult {\n  status: OperationResultStatus;\n  data?: Record<string, unknown>;\n  newVersion?: number;\n  fieldMeta?: FieldMetaMap;\n  error?: {\n    type: MutationErrorType;\n    status?: number;\n    validationErrors?: Record<string, unknown>;\n    message?: string;\n    /** Populated when the backend supplies authoritative state on version conflict (409). */\n    conflictDetails?: MutationError['conflictDetails'];\n  };\n}\n\n// --- Error Classes ---\n\nexport class MutationCancelledError extends Error {\n  override readonly name = 'MutationCancelledError';\n  readonly source?: MutationSource;\n\n  constructor(source?: MutationSource) {\n    super('Mutation cancelled');\n    this.source = source;\n  }\n}\n\nexport class ResourceDeletedError extends Error {\n  override readonly name = 'ResourceDeletedError';\n\n  constructor() {\n    super('Resource has been deleted');\n  }\n}\n\nexport class BackpressureRejectedError extends Error {\n  override readonly name = 'BackpressureRejectedError';\n\n  constructor() {\n    super('Queue at maximum depth — mutation rejected');\n  }\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAKhF,gBAAgB;AAEhB,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,2BAAe,CAAA;IACf,iCAAqB,CAAA;IACrB,+BAAmB,CAAA;AACrB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,mDAAmC,CAAA;IACnC,+CAA+B,CAAA;IAC/B,iDAAiC,CAAA;IACjC,qDAAqC,CAAA;AACvC,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED,MAAM,CAAN,IAAY,YAQX;AARD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;IACjB,+BAAe,CAAA;IACf,mCAAmB,CAAA;IACnB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,iCAAiB,CAAA;AACnB,CAAC,EARW,YAAY,KAAZ,YAAY,QAQvB;AAED,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,yCAAmB,CAAA;IACnB,mDAA6B,CAAA;IAC7B,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED,MAAM,CAAN,IAAY,iBAOX;AAPD,WAAY,iBAAiB;IAC3B,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;IACrB,4CAAuB,CAAA;IACvB,4CAAuB,CAAA;IACvB,sCAAiB,CAAA;IACjB,oCAAe,CAAA;AACjB,CAAC,EAPW,iBAAiB,KAAjB,iBAAiB,QAO5B;AAED,MAAM,CAAN,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,4CAAmB,CAAA;IACnB,wCAAe,CAAA;AACjB,CAAC,EAHW,qBAAqB,KAArB,qBAAqB,QAGhC;AAED,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,mDAA+B,CAAA;IAC/B,uDAAmC,CAAA;AACrC,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,uDAAqC,CAAA;IACrC,iDAA+B,CAAA;AACjC,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,mCAAiB,CAAA;AACnB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,qDAAO,CAAA;IACP,2DAAU,CAAA;IACV,uDAAQ,CAAA;IACR,iEAAa,CAAA;AACf,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B;AAkMD,wBAAwB;AAExB,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,IAAI,GAAG,wBAAwB,CAAC;IACzC,MAAM,CAAkB;IAEjC,YAAY,MAAuB;QACjC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3B,IAAI,GAAG,sBAAsB,CAAC;IAEhD;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChC,IAAI,GAAG,2BAA2B,CAAC;IAErD;QACE,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACtD,CAAC;CACF","sourcesContent":["// =============================================================================\n// RMM Module — Type Definitions\n// =============================================================================\n\nimport type { DataMode, FieldMetaEntry, FieldMetaMap } from '@wildo-ai/saas-models';\nimport type { CrdtResolutionWinner } from '@wildo-ai/saas-models';\n\n// --- Enums ---\n\nexport enum RMMState {\n  IDLE = 'IDLE',\n  QUEUED = 'QUEUED',\n  SAVING = 'SAVING',\n  ERROR = 'ERROR',\n  CONFLICT = 'CONFLICT',\n  DELETED = 'DELETED',\n}\n\nexport enum RMMEventType {\n  MUTATION_RESULT = 'mutation_result',\n  REMOTE_UPDATE = 'remote_update',\n  CONFLICT_RESET = 'conflict_reset',\n  RESOURCE_DELETED = 'resource_deleted',\n}\n\nexport enum MutationType {\n  AUTOSAVE = 'autosave',\n  SUBMIT = 'submit',\n  DRAFT = 'draft',\n  PUBLISH = 'publish',\n  SECTION = 'section',\n  INLINE = 'inline',\n  CUSTOM = 'custom',\n}\n\nexport enum MutationSourceType {\n  FORM = 'form',\n  DISPLAY = 'display',\n  ORCHESTRATOR = 'orchestrator',\n  CUSTOM = 'custom',\n}\n\nexport enum MutationErrorType {\n  VALIDATION = 'validation',\n  CONFLICT = 'conflict',\n  NOT_FOUND = 'not_found',\n  TRANSIENT = 'transient',\n  SERVER = 'server',\n  ABORT = 'abort',\n}\n\nexport enum OperationResultStatus {\n  SUCCESS = 'success',\n  ERROR = 'error',\n}\n\nexport enum ConflictStrategy {\n  ACCEPT_REMOTE = 'accept-remote',\n  LAST_WRITE_WINS = 'last-write-wins',\n}\n\nexport enum ConflictReason {\n  VERSION_CONFLICT = 'version_conflict',\n  REMOTE_UPDATE = 'remote_update',\n}\n\nexport enum DeletionReason {\n  LOCAL = 'local',\n  REMOTE = 'remote',\n}\n\nexport enum MutationPriority {\n  LOW = 0,\n  NORMAL = 1,\n  HIGH = 2,\n  IMMEDIATE = 3,\n}\n\n// --- Events (Declarative Event Model §2.6) ---\n\n/**\n * Events set on `_lastEvent` to drive consumer side effects via `useEffect`.\n * Each event carries a monotonic `id` for dedup: `useEffect([snapshot.lastEvent?.id])`.\n */\nexport type RMMEvent =\n  | { type: RMMEventType.MUTATION_RESULT; result: MutationResult; source: MutationSource; id: number }\n  | { type: RMMEventType.REMOTE_UPDATE; changedFields: string[]; mergedFields: string[]; version: number; initiatorUserId: string; crdtResolutions?: Record<string, CrdtResolutionWinner>; id: number }\n  | {\n      type: RMMEventType.CONFLICT_RESET;\n      discardedFields: string[];\n      reason: ConflictReason;\n      currentData: Record<string, unknown>;\n      currentVersion: number;\n      conflictDetails?: MutationError['conflictDetails'];\n      id: number;\n    }\n  | { type: RMMEventType.RESOURCE_DELETED; reason: DeletionReason; deletedBy?: string; id: number };\n\n// --- Snapshot (for useSyncExternalStore) ---\n\nexport interface RMMSnapshot {\n  state: RMMState;\n  version: number | null;\n  confirmedData: Record<string, unknown> | null;\n  optimisticData: Record<string, unknown> | null;\n  pendingFieldNames: string[];\n  pendingFieldValues: Readonly<Record<string, unknown>>;\n  isSaving: boolean;\n  isDeleted: boolean;\n  hasUnsavedChanges: boolean;\n  error: MutationError | null;\n  queueDepth: number;\n  lastEvent: RMMEvent | null;\n}\n\n// --- Config ---\n\nexport interface ResourceMutationManagerConfig {\n  resourceType: string;\n  resourceId: string | null;\n  transportAdapter: TransportAdapter;\n  conflictPolicy: ConflictPolicy;\n  currentUserId: string;\n  contextResourceIdentifiers?: Record<string, string>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  resourceSchema?: unknown;\n  /** Operation path key for doOperation() routing. Falls back to resourceType if not provided. */\n  operationPathKey?: string;\n  /** Optional READ path used when custom mutations need an authoritative refresh. */\n  readOperationPathKey?: string;\n  /**\n   * Optional backpressure overrides (tests, slow networks). Defaults match\n   * `ResourceMutationManager` internal `DEFAULT_BACKPRESSURE`. Only keys you set\n   * are applied; omitted keys keep defaults (explicit `undefined` does not zero timers).\n   *\n   * With `useResourceMutationManager`, config is captured on first `getOrCreate` for\n   * the registry key — changing `backpressure` on a later render has no effect.\n   */\n  backpressure?: Partial<BackpressureConfig>;\n}\n\n// --- Mutation Types ---\n\nexport interface MutationQueueEntry {\n  id: string;\n  type: MutationType;\n  fields: Record<string, unknown>;\n  priority: MutationPriority;\n  source: MutationSource;\n  resolve: (result: MutationResult) => void;\n  reject: (error: Error) => void;\n  signal?: AbortSignal;\n  transportOverride?: MutationTransportOverride;\n}\n\nexport interface MutationSource {\n  type: MutationSourceType;\n  subscriberId: string;\n}\n\nexport interface MutationTransportOverride {\n  operationPathKey?: string;\n  contextualParameters?: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  requestData?: Record<string, unknown>;\n  readBackOnSuccess?: boolean;\n}\n\nexport interface MutationResult {\n  success: boolean;\n  savedFields?: string[];\n  newVersion?: number;\n  responseData?: Record<string, unknown>;\n  error?: MutationError;\n  retriesRemaining?: number;\n}\n\nexport interface MutationError {\n  type: MutationErrorType;\n  status?: number;\n  validationErrors?: Record<string, unknown>;\n  conflictDetails?: {\n    currentVersion: number;\n    expectedVersion: number;\n    conflictingFields: string[];\n    currentValues: Record<string, unknown>;\n    submittedValues: Record<string, unknown>;\n  };\n  message?: string;\n  /**\n   * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's\n   * reference, error type and user guidance. `type` is a coarse RETRY classification (every non-conflict 4xx\n   * is `VALIDATION`), so a surface that shows the failure to a person resolves THIS through\n   * `useUserFacingErrorMessage()` rather than `type` or `message`.\n   */\n  cause?: unknown;\n}\n\nexport interface ActiveMutation {\n  entry: MutationQueueEntry;\n  savingFields: Record<string, unknown>;\n  abortController: AbortController;\n  retryCount: number;\n}\n\n// --- Conflict + CRDT Types ---\n\nexport interface ConflictPolicy {\n  strategy: ConflictStrategy;\n}\n\nexport interface DeferredSelfEvent {\n  changedFields: Record<string, unknown>;\n  version: number;\n  initiatorUserId: string;\n  fieldMeta?: Record<string, FieldMetaEntry>;\n}\n\nexport interface CRDTFieldTimestamps {\n  [fieldPath: string]: number;\n}\n\n// --- Backpressure ---\n\nexport interface BackpressureConfig {\n  maxQueueDepth: number;\n  softTimeoutMs: number;\n  hardTimeoutMs: number;\n}\n\n// --- Transport ---\n\nexport interface TransportAdapter {\n  execute(descriptor: OperationDescriptor): Promise<OperationResult>;\n}\n\nexport interface OperationDescriptor {\n  operationPathKey: string;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  dataMode?: DataMode;\n  requestData?: Record<string, unknown>;\n  expectedVersion?: number | null;\n  signal?: AbortSignal;\n  fieldTimestamps?: CRDTFieldTimestamps;\n}\n\nexport interface OperationResult {\n  status: OperationResultStatus;\n  data?: Record<string, unknown>;\n  newVersion?: number;\n  fieldMeta?: FieldMetaMap;\n  error?: {\n    type: MutationErrorType;\n    status?: number;\n    validationErrors?: Record<string, unknown>;\n    message?: string;\n    /** Populated when the backend supplies authoritative state on version conflict (409). */\n    conflictDetails?: MutationError['conflictDetails'];\n    /**\n     * The transport failure exactly as it was caught — the HTTP client's error, carrying the backend's\n     * reference, error type and user guidance. `type` is a coarse RETRY classification (every non-conflict 4xx\n     * is `VALIDATION`), so a surface that shows the failure to a person resolves THIS through\n     * `useUserFacingErrorMessage()` rather than `type` or `message`.\n     */\n    cause?: unknown;\n  };\n}\n\n// --- Error Classes ---\n\nexport class MutationCancelledError extends Error {\n  override readonly name = 'MutationCancelledError';\n  readonly source?: MutationSource;\n\n  constructor(source?: MutationSource) {\n    super('Mutation cancelled');\n    this.source = source;\n  }\n}\n\nexport class ResourceDeletedError extends Error {\n  override readonly name = 'ResourceDeletedError';\n\n  constructor() {\n    super('Resource has been deleted');\n  }\n}\n\nexport class BackpressureRejectedError extends Error {\n  override readonly name = 'BackpressureRejectedError';\n\n  constructor() {\n    super('Queue at maximum depth — mutation rejected');\n  }\n}\n"]}

package/dist/esm/core/resources/rmm/update-like-mutation-fallback.frontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-like-mutation-fallback.frontend.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,oBAAY,8BAA8B;IACxC,YAAY,iBAAiB;IAC7B,yBAAyB,8BAA8B;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAE1B,MAAM,EAAE,4BAA4B;CAcjD;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,8BAA8B,GAAG,SAAS,GAC/C,OAAO,CAET"}
+{"version":3,"file":"update-like-mutation-fallback.frontend.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,oBAAY,8BAA8B;IACxC,YAAY,iBAAiB;IAC7B,yBAAyB,8BAA8B;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAE1B,MAAM,EAAE,4BAA4B;CAcjD;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,8BAA8B,GAAG,SAAS,GAC/C,OAAO,CAET"}

package/dist/esm/core/resources/rmm/update-like-mutation-fallback.frontend.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-like-mutation-fallback.frontend.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,8BAGX;AAHD,WAAY,8BAA8B;IACxC,+DAA6B,CAAA;IAC7B,yFAAuD,CAAA;AACzD,CAAC,EAHW,8BAA8B,KAA9B,8BAA8B,QAGzC;AAQD;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,WAAW,CAAS;IACpB,YAAY,CAAS;IACrB,mBAAmB,CAAU;IAEtC,YAAY,MAAoC;QAC9C,MAAM,eAAe,GAAG,MAAM,CAAC,mBAAmB;YAChD,CAAC,CAAC,mBAAmB,MAAM,CAAC,mBAAmB,GAAG;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CACH,GAAG,MAAM,CAAC,WAAW,sEAAsE;YAC3F,IAAI,MAAM,CAAC,YAAY,IAAI,eAAe,gDAAgD;YAC1F,4FAA4F,CAC7F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC;IACxD,CAAC;CACF;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAgD;IAEhD,OAAO,IAAI,KAAK,8BAA8B,CAAC,yBAAyB,CAAC;AAC3E,CAAC","sourcesContent":["/**\n * Step 6 escape-hatch classification for framework mutation surfaces.\n *\n * Default engine surfaces should behave as if RMM-backed update semantics are a\n * real contract, not a best-effort preference. When a caller knowingly wants a\n * weaker direct `doOperation()` path instead, that downgrade must be explicit.\n *\n * Important: the richer RMM conflict UX is only guaranteed on the single-\n * resource RMM-backed update-like lane where the backend emits authoritative\n * nested `versionConflict` details. Explicit direct fallbacks and true bulk\n * direct lanes remain weaker-guarantee paths even when they are semantically\n * \"update-like\".\n */\n\n/**\n * Controls whether update-like framework surfaces may silently downgrade to a\n * direct `doOperation()` mutation when RMM is unavailable.\n *\n * `RMM_REQUIRED` is the engine-default contract for single-resource update-like\n * surfaces.\n * `DIRECT_OPERATION_FALLBACK` is an explicit weaker-guarantee lane for advanced\n * callers that knowingly accept the semantic downgrade, including the loss of\n * guaranteed authoritative conflict-detail handling.\n */\nexport enum UpdateLikeMutationFallbackMode {\n  RMM_REQUIRED = 'RMM_REQUIRED',\n  DIRECT_OPERATION_FALLBACK = 'DIRECT_OPERATION_FALLBACK',\n}\n\nexport interface MissingRMMRuntimeErrorParams {\n  surfaceName: string;\n  resourceType: string;\n  operationIdentifier?: string;\n}\n\n/**\n * Raised when a default single-resource update-like framework surface is mounted\n * without the RMM runtime it semantically expects.\n */\nexport class MissingRMMRuntimeError extends Error {\n  readonly surfaceName: string;\n  readonly resourceType: string;\n  readonly operationIdentifier?: string;\n\n  constructor(params: MissingRMMRuntimeErrorParams) {\n    const operationSuffix = params.operationIdentifier\n      ? ` for operation \"${params.operationIdentifier}\"`\n      : '';\n    super(\n      `${params.surfaceName} requires RMM for its default update-like mutation path on resource ` +\n      `\"${params.resourceType}\"${operationSuffix}. Mount RMMRegistryProvider or explicitly opt ` +\n      `into UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK to accept weaker guarantees.`,\n    );\n    this.name = 'MissingRMMRuntimeError';\n    this.surfaceName = params.surfaceName;\n    this.resourceType = params.resourceType;\n    this.operationIdentifier = params.operationIdentifier;\n  }\n}\n\nexport function allowsDirectOperationFallback(\n  mode: UpdateLikeMutationFallbackMode | undefined,\n): boolean {\n  return mode === UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK;\n}\n"]}
+{"version":3,"file":"update-like-mutation-fallback.frontend.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/update-like-mutation-fallback.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,8BAGX;AAHD,WAAY,8BAA8B;IACxC,+DAA6B,CAAA;IAC7B,yFAAuD,CAAA;AACzD,CAAC,EAHW,8BAA8B,KAA9B,8BAA8B,QAGzC;AAQD;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,WAAW,CAAS;IACpB,YAAY,CAAS;IACrB,mBAAmB,CAAU;IAEtC,YAAY,MAAoC;QAC9C,MAAM,eAAe,GAAG,MAAM,CAAC,mBAAmB;YAChD,CAAC,CAAC,mBAAmB,MAAM,CAAC,mBAAmB,GAAG;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CACH,GAAG,MAAM,CAAC,WAAW,sEAAsE;YAC3F,IAAI,MAAM,CAAC,YAAY,IAAI,eAAe,gDAAgD;YAC1F,4FAA4F,CAC7F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC;IACxD,CAAC;CACF;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAgD;IAEhD,OAAO,IAAI,KAAK,8BAA8B,CAAC,yBAAyB,CAAC;AAC3E,CAAC","sourcesContent":["/**\n * Step 6 escape-hatch classification for framework mutation surfaces.\n *\n * Default engine surfaces should behave as if RMM-backed update semantics are a\n * real contract, not a best-effort preference. When a caller knowingly wants a\n * weaker direct `doOperation()` path instead, that downgrade must be explicit.\n *\n * Important: the richer RMM conflict UX is only guaranteed on the single-\n * resource RMM-backed update-like lane where the backend emits authoritative\n * nested `versionConflict` details. Explicit direct fallbacks and true bulk\n * direct lanes remain weaker-guarantee paths even when they are semantically\n * \"update-like\".\n */\n\n/**\n * Controls whether update-like framework surfaces may silently downgrade to a\n * direct `doOperation()` mutation when RMM is unavailable.\n *\n * `RMM_REQUIRED` is the engine-default contract for single-resource update-like\n * surfaces.\n * `DIRECT_OPERATION_FALLBACK` is an explicit weaker-guarantee lane for advanced\n * callers that knowingly accept the semantic downgrade, including the loss of\n * guaranteed authoritative conflict-detail handling.\n */\nexport enum UpdateLikeMutationFallbackMode {\n  RMM_REQUIRED = 'RMM_REQUIRED',\n  DIRECT_OPERATION_FALLBACK = 'DIRECT_OPERATION_FALLBACK',\n}\n\nexport interface MissingRMMRuntimeErrorParams {\n  surfaceName: string;\n  resourceType: string;\n  operationIdentifier?: string;\n}\n\n/**\n * Raised when a default single-resource update-like framework surface is mounted\n * without the RMM runtime it semantically expects.\n */\nexport class MissingRMMRuntimeError extends Error {\n  readonly surfaceName: string;\n  readonly resourceType: string;\n  readonly operationIdentifier?: string;\n\n  constructor(params: MissingRMMRuntimeErrorParams) {\n    const operationSuffix = params.operationIdentifier\n      ? ` for operation \"${params.operationIdentifier}\"`\n      : '';\n    super(\n      `${params.surfaceName} requires RMM for its default update-like mutation path on resource ` +\n      `\"${params.resourceType}\"${operationSuffix}. Mount RMMRegistryProvider or explicitly opt ` +\n      `into UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK to accept weaker guarantees.`,\n    );\n    this.name = 'MissingRMMRuntimeError';\n    this.surfaceName = params.surfaceName;\n    this.resourceType = params.resourceType;\n    this.operationIdentifier = params.operationIdentifier;\n  }\n}\n\nexport function allowsDirectOperationFallback(\n  mode: UpdateLikeMutationFallbackMode | undefined,\n): boolean {\n  return mode === UpdateLikeMutationFallbackMode.DIRECT_OPERATION_FALLBACK;\n}\n"]}

package/dist/esm/core/resources/rmm/useListInvalidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useListInvalidation.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useListInvalidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAOtH,MAAM,WAAW,yBAAyB;IACxC,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,2BAA2B,EAAE,OAAO,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,gCAAgC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACrE,cAAc,CAAC,EAAE,KAAK,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAC;CACvE;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,uBAAuB,GAAG,IAAI,EACnC,MAAM,EAAE,yBAAyB,GAChC,IAAI,CAmDN"}
+{"version":3,"file":"useListInvalidation.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useListInvalidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAOtH,MAAM,WAAW,yBAAyB;IACxC,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,2BAA2B,EAAE,OAAO,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,gCAAgC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACrE,cAAc,CAAC,EAAE,KAAK,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAC;CACvE;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,uBAAuB,GAAG,IAAI,EACnC,MAAM,EAAE,yBAAyB,GAChC,IAAI,CAmDN"}

package/dist/esm/core/resources/rmm/useListInvalidation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useListInvalidation.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useListInvalidation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useListInvalidation — Emits RESOURCE_REFRESH on the EventBus when a mutation\n * succeeds AND WebSocket is disconnected (Decision R17).\n *\n * When WS is connected, the WebSocketEventBridge already handles list refresh —\n * emitting here would cause double-refetch. This hook is the fallback path for\n * when the WS bridge is unavailable.\n *\n * Uses `CoreResourceOperation.LIST` as `operationIdentifier` to match the pattern\n * in `useResourceOperationActions.ts`. List surfaces consume these through\n * `resourceCollectionRefreshEvent` in `useEventBus.ts` (the COLLECTION-scoped\n * subscription with SUBSET scope matching — wired into `ResourceLayout_List`'s\n * fetch on 2026-08-19; until then the chain had no collection consumer at all,\n * wildo-ai/wildo-ai#33).\n *\n * Strips `rmm.resourceType` from `contextResourceIdentifiers` before emitting so\n * the payload carries the parent scope only. The subset matcher tolerates the\n * transport-normalization leftovers (dual-spelled keys, a surviving self\n * field-identifier key) by construction, so producers only need the type-key strip.\n */\n\nimport { useContext, useEffect, useRef, useSyncExternalStore } from 'react';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { WebSocketContext } from '~wildo-frontend-lib/core/requests/websockets/WebSocketContext';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { RMMEventType } from './types';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { FrontendEventResourceOperation } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useListInvalidation');\nlogger.setDebugTypeLogging('useListInvalidation', false);\n\nexport interface UseListInvalidationConfig {\n  contextResourceIdentifiers: Record<string, string>;\n  parentResourcesRequirements: unknown[];\n  listOperation?: FrontendResourceOperationContext['operation'] | null;\n  listOperations?: Array<FrontendResourceOperationContext['operation']>;\n}\n\nexport function useListInvalidation(\n  rmm: ResourceMutationManager | null,\n  config: UseListInvalidationConfig,\n): void {\n  const snapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n  const { emit } = useEventBus();\n  const webSocket = useContext(WebSocketContext);\n  const isConnected = webSocket?.isConnected ?? false;\n\n  const isConnectedRef = useRef(isConnected);\n  isConnectedRef.current = isConnected;\n  const configRef = useRef(config);\n  configRef.current = config;\n\n  useEffect(() => {\n    if (\n      rmm &&\n      snapshot.lastEvent?.type === RMMEventType.MUTATION_RESULT &&\n      snapshot.lastEvent.result.success &&\n      !isConnectedRef.current\n    ) {\n      const { [rmm.resourceType]: _self, ...parentScopeIdentifiers } = configRef.current.contextResourceIdentifiers;\n      const listRefreshTargets = configRef.current.listOperations?.length\n        ? configRef.current.listOperations\n        : [configRef.current.listOperation ?? null];\n\n      for (const listOperation of listRefreshTargets) {\n        const payload: FrontendEventResourceOperation = {\n          resourceType: rmm.resourceType,\n          operationIdentifier: String(\n            listOperation?.operationIdentifier ?? CoreResourceOperation.LIST,\n          ),\n          variantType: listOperation?.variantType,\n          isOperationDefault: listOperation?.isOperationDefault ?? true,\n          isBulkOperation: listOperation?.isBulkOperation ?? false,\n          variantKey: listOperation?.variantKey,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          parentResourcesRequirements: configRef.current\n            .parentResourcesRequirements as FrontendResourceOperationContext['parentResourcesRequirements'],\n          operation: listOperation\n            ?? ({ operationIdentifier: CoreResourceOperation.LIST } as FrontendResourceOperationContext['operation']),\n        };\n        emit(FrontendEvents.RESOURCE_REFRESH, payload);\n      }\n      logDebug('list invalidation triggered', {\n        resourceType: rmm.resourceType,\n        isConnected: isConnectedRef.current,\n      });\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: rmm, emit are stable refs; config/isConnected via refs above\n  }, [snapshot.lastEvent?.id]);\n}\n"]}
+{"version":3,"file":"useListInvalidation.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useListInvalidation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * useListInvalidation — Emits RESOURCE_REFRESH on the EventBus when a mutation\n * succeeds AND WebSocket is disconnected (Decision R17).\n *\n * When WS is connected, the WebSocketEventBridge already handles list refresh —\n * emitting here would cause double-refetch. This hook is the fallback path for\n * when the WS bridge is unavailable.\n *\n * Uses `CoreResourceOperation.LIST` as `operationIdentifier` to match the pattern\n * in `useResourceOperationActions.ts`. List surfaces consume these through\n * `resourceCollectionRefreshEvent` in `useEventBus.ts` (the COLLECTION-scoped\n * subscription with SUBSET scope matching — wired into `ResourceLayout_List`'s\n * fetch on 2026-08-19; until then the chain had no collection consumer at all,\n * wildo-ai/wildo-ai#33).\n *\n * Strips `rmm.resourceType` from `contextResourceIdentifiers` before emitting so\n * the payload carries the parent scope only. The subset matcher tolerates the\n * transport-normalization leftovers (dual-spelled keys, a surviving self\n * field-identifier key) by construction, so producers only need the type-key strip.\n */\n\nimport { useContext, useEffect, useRef, useSyncExternalStore } from 'react';\nimport { useEventBus } from '~wildo-frontend-lib/core/events/useEventBus';\nimport { WebSocketContext } from '~wildo-frontend-lib/core/requests/websockets/WebSocketContext';\nimport { FrontendEvents } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport { CoreResourceOperation } from '@wildo-ai/saas-models';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { RMMEventType } from './types';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { FrontendEventResourceOperation } from '~wildo-frontend-lib/core/events/events.frontend.schemas';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useListInvalidation');\nlogger.setDebugTypeLogging('useListInvalidation', false);\n\nexport interface UseListInvalidationConfig {\n  contextResourceIdentifiers: Record<string, string>;\n  parentResourcesRequirements: unknown[];\n  listOperation?: FrontendResourceOperationContext['operation'] | null;\n  listOperations?: Array<FrontendResourceOperationContext['operation']>;\n}\n\nexport function useListInvalidation(\n  rmm: ResourceMutationManager | null,\n  config: UseListInvalidationConfig,\n): void {\n  const snapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n  const { emit } = useEventBus();\n  const webSocket = useContext(WebSocketContext);\n  const isConnected = webSocket?.isConnected ?? false;\n\n  const isConnectedRef = useRef(isConnected);\n  isConnectedRef.current = isConnected;\n  const configRef = useRef(config);\n  configRef.current = config;\n\n  useEffect(() => {\n    if (\n      rmm &&\n      snapshot.lastEvent?.type === RMMEventType.MUTATION_RESULT &&\n      snapshot.lastEvent.result.success &&\n      !isConnectedRef.current\n    ) {\n      const { [rmm.resourceType]: _self, ...parentScopeIdentifiers } = configRef.current.contextResourceIdentifiers;\n      const listRefreshTargets = configRef.current.listOperations?.length\n        ? configRef.current.listOperations\n        : [configRef.current.listOperation ?? null];\n\n      for (const listOperation of listRefreshTargets) {\n        const payload: FrontendEventResourceOperation = {\n          resourceType: rmm.resourceType,\n          operationIdentifier: String(\n            listOperation?.operationIdentifier ?? CoreResourceOperation.LIST,\n          ),\n          variantType: listOperation?.variantType,\n          isOperationDefault: listOperation?.isOperationDefault ?? true,\n          isBulkOperation: listOperation?.isBulkOperation ?? false,\n          variantKey: listOperation?.variantKey,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          parentResourcesRequirements: configRef.current\n            .parentResourcesRequirements as FrontendResourceOperationContext['parentResourcesRequirements'],\n          operation: listOperation\n            ?? ({ operationIdentifier: CoreResourceOperation.LIST } as FrontendResourceOperationContext['operation']),\n        };\n        emit(FrontendEvents.RESOURCE_REFRESH, payload);\n      }\n      logDebug('list invalidation triggered', {\n        resourceType: rmm.resourceType,\n        isConnected: isConnectedRef.current,\n      });\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- intentional: rmm, emit are stable refs; config/isConnected via refs above\n  }, [snapshot.lastEvent?.id]);\n}\n"]}

package/dist/esm/core/resources/rmm/useRMMEventHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRMMEventHandler.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useRMMEventHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GACjC,IAAI,CAWN"}
+{"version":3,"file":"useRMMEventHandler.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useRMMEventHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GACjC,IAAI,CAWN"}

package/dist/esm/core/resources/rmm/useRMMEventHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"useRMMEventHandler.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useRMMEventHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,MAAM,UAAU,kBAAkB,CAChC,GAA4B,EAC5B,OAAkC;IAElC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QACD,mFAAmF;IACrF,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["/**\n * useRMMEventHandler Hook\n *\n * Convenience hook for reacting to RMM events. Fires the handler once per\n * observed event id during the current mount; remounting with the same last\n * event still replays that current snapshot event.\n *\n * Consumers can also inline the useEffect directly — this is just a shorthand.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { useRMMSnapshot } from './useRMMSnapshot';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMEvent } from './types';\n\nexport function useRMMEventHandler(\n  rmm: ResourceMutationManager,\n  handler: (event: RMMEvent) => void,\n): void {\n  const snapshot = useRMMSnapshot(rmm);\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  useEffect(() => {\n    if (snapshot.lastEvent) {\n      handlerRef.current(snapshot.lastEvent);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- react only to new events\n  }, [snapshot.lastEvent?.id]);\n}\n"]}
+{"version":3,"file":"useRMMEventHandler.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useRMMEventHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,MAAM,UAAU,kBAAkB,CAChC,GAA4B,EAC5B,OAAkC;IAElC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QACD,mFAAmF;IACrF,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["/**\n * useRMMEventHandler Hook\n *\n * Convenience hook for reacting to RMM events. Fires the handler once per\n * observed event id during the current mount; remounting with the same last\n * event still replays that current snapshot event.\n *\n * Consumers can also inline the useEffect directly — this is just a shorthand.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { useRMMSnapshot } from './useRMMSnapshot';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMEvent } from './types';\n\nexport function useRMMEventHandler(\n  rmm: ResourceMutationManager,\n  handler: (event: RMMEvent) => void,\n): void {\n  const snapshot = useRMMSnapshot(rmm);\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  useEffect(() => {\n    if (snapshot.lastEvent) {\n      handlerRef.current(snapshot.lastEvent);\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- react only to new events\n  }, [snapshot.lastEvent?.id]);\n}\n"]}

package/dist/esm/core/resources/rmm/useRMMSnapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRMMSnapshot.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useRMMSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,wBAAgB,cAAc,CAAC,GAAG,EAAE,uBAAuB,GAAG,WAAW,CAExE"}
+{"version":3,"file":"useRMMSnapshot.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useRMMSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,wBAAgB,cAAc,CAAC,GAAG,EAAE,uBAAuB,GAAG,WAAW,CAExE"}

package/dist/esm/core/resources/rmm/useRMMSnapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"useRMMSnapshot.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useRMMSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAI7C,MAAM,UAAU,cAAc,CAAC,GAA4B;IACzD,OAAO,oBAAoB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;AAC9D,CAAC","sourcesContent":["/**\n * useRMMSnapshot Hook\n *\n * Separated from RMMRegistryContext.tsx for React Fast Refresh compatibility.\n *\n * Thin wrapper around useSyncExternalStore. RMM.subscribe and RMM.getSnapshot\n * are pre-bound in the constructor — safe to pass as stable references.\n */\n\nimport { useSyncExternalStore } from 'react';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMSnapshot } from './types';\n\nexport function useRMMSnapshot(rmm: ResourceMutationManager): RMMSnapshot {\n  return useSyncExternalStore(rmm.subscribe, rmm.getSnapshot);\n}\n"]}
+{"version":3,"file":"useRMMSnapshot.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useRMMSnapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAI7C,MAAM,UAAU,cAAc,CAAC,GAA4B;IACzD,OAAO,oBAAoB,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;AAC9D,CAAC","sourcesContent":["/**\n * useRMMSnapshot Hook\n *\n * Separated from RMMRegistryContext.tsx for React Fast Refresh compatibility.\n *\n * Thin wrapper around useSyncExternalStore. RMM.subscribe and RMM.getSnapshot\n * are pre-bound in the constructor — safe to pass as stable references.\n */\n\nimport { useSyncExternalStore } from 'react';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMSnapshot } from './types';\n\nexport function useRMMSnapshot(rmm: ResourceMutationManager): RMMSnapshot {\n  return useSyncExternalStore(rmm.subscribe, rmm.getSnapshot);\n}\n"]}

package/dist/esm/core/resources/rmm/useResourceMutationManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceMutationManager.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useResourceMutationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,6BAA6B,EAAE,cAAc,GAAG,YAAY,GAAG,eAAe,CAAC,CAAC;AAYhH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,uBAAuB,CAwDzB"}
+{"version":3,"file":"useResourceMutationManager.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceMutationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,6BAA6B,EAAE,cAAc,GAAG,YAAY,GAAG,eAAe,CAAC,CAAC;AAYhH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,uBAAuB,CAwDzB"}

package/dist/esm/core/resources/rmm/useResourceMutationManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceMutationManager.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useResourceMutationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAM5E;;;GAGG;AACH,SAAS,cAAc;IACrB,MAAM,QAAQ,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACrG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,YAAoB,EACpB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,GAAG,WAAW,EAAE,CAAC;IACzD,MAAM,YAAY,GAAG,wBAAwB,EAAE,MAAM,IAAI,IAAI,CAAC;IAC9D,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,yBAAyB,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC;QAC9B,yBAAyB,CAAC,OAAO,GAAG,IAAI,EAAE,GAAG,IAAI,YAAa,CAAC;IACjE,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,EAAE,GAAG,IAAI,YAAY,IAAI,yBAAyB,CAAC,OAAO,CAAC;IAErF,MAAM,GAAG,GAAG,OAAO,CACjB,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,EAAE;QACnD,GAAG,MAAM;QACT,YAAY;QACZ,UAAU;QACV,aAAa;QACb,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;KACpE,CAAC;IACF,6FAA6F;IAC7F,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CACrC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,wBAAwB,CAAC;YAC3B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,aAAa;YACb,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;YACnE,oBAAoB,EAAE,EAAE,GAAG,MAAM,CAAC,oBAAoB,EAAE;YACxD,2BAA2B,EAAE,MAAM,CAAC,2BAA2B;YAC/D,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC,CAAC;QACH,QAAQ,CAAC,4BAA4B,EAAE,CAAC;IAC1C,CAAC,EAAE;QACD,QAAQ;QACR,GAAG;QACH,aAAa;QACb,MAAM,CAAC,0BAA0B;QACjC,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,2BAA2B;QAClC,MAAM,CAAC,gBAAgB;QACvB,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,gBAAgB;KACxB,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["/**\n * useResourceMutationManager Hook\n *\n * Separated from RMMRegistryContext.tsx for React Fast Refresh compatibility.\n *\n * Wraps RMMRegistry.getOrCreate + cleanup. Injects currentUserId from auth context.\n * Initial config is captured at first `getOrCreate`; a `useEffect` then calls\n * `syncRuntimeRoutingConfig` whenever routing/auth/conflict/CRDT semantics\n * change so reused instances stay aligned without remounting. `backpressure`\n * remains creation-time configuration for this low-level hook.\n */\n\nimport { useMemo, useEffect, useContext, useRef } from 'react';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { ResourceMutationManagerConfig } from './types';\n\nexport type UseRMMConfig = Omit<ResourceMutationManagerConfig, 'resourceType' | 'resourceId' | 'currentUserId'>;\n\n/**\n * Local helper — not extracted to its own file because only this hook needs\n * raw registry access. If other hooks need it later, extract to a separate file.\n */\nfunction useRMMRegistry() {\n  const registry = useContext(RMMRegistryContext);\n  if (!registry) throw new Error('useResourceMutationManager must be used within RMMRegistryProvider');\n  return registry;\n}\n\nexport function useResourceMutationManager(\n  resourceType: string,\n  resourceId: string,\n  config: UseRMMConfig,\n): ResourceMutationManager {\n  const registry = useRMMRegistry();\n  const { user, primaryScopeInitiatorIds } = useUserOrgs();\n  const scopedUserId = primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so the reused RMM runtime keeps a stable self-event identity.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = user?._id ?? scopedUserId!;\n  }\n  const currentUserId = user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n\n  const rmm = useMemo(\n    () => registry.getOrCreate(resourceType, resourceId, {\n      ...config,\n      resourceType,\n      resourceId,\n      currentUserId,\n      contextResourceIdentifiers: config.contextResourceIdentifiers ?? {},\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- config is immutable after creation\n    [registry, resourceType, resourceId],\n  );\n\n  useEffect(() => {\n    return () => registry.release(registry.keyFor(resourceType, resourceId));\n  }, [registry, resourceType, resourceId]);\n\n  useEffect(() => {\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter: config.transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: config.contextResourceIdentifiers ?? {},\n      contextualParameters: { ...config.contextualParameters },\n      parentResourcesRequirements: config.parentResourcesRequirements,\n      operationPathKey: config.operationPathKey,\n      readOperationPathKey: config.readOperationPathKey,\n      conflictPolicy: config.conflictPolicy,\n      resourceSchema: config.resourceSchema,\n    });\n    registry.notifyInstanceRuntimeChanged();\n  }, [\n    registry,\n    rmm,\n    currentUserId,\n    config.contextResourceIdentifiers,\n    config.contextualParameters,\n    config.parentResourcesRequirements,\n    config.operationPathKey,\n    config.readOperationPathKey,\n    config.conflictPolicy,\n    config.resourceSchema,\n    config.transportAdapter,\n  ]);\n\n  return rmm;\n}\n"]}
+{"version":3,"file":"useResourceMutationManager.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceMutationManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAM5E;;;GAGG;AACH,SAAS,cAAc;IACrB,MAAM,QAAQ,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACrG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,YAAoB,EACpB,UAAkB,EAClB,MAAoB;IAEpB,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,wBAAwB,EAAE,GAAG,WAAW,EAAE,CAAC;IACzD,MAAM,YAAY,GAAG,wBAAwB,EAAE,MAAM,IAAI,IAAI,CAAC;IAC9D,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,yBAAyB,GAAG,MAAM,CAAS,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC;QAC9B,yBAAyB,CAAC,OAAO,GAAG,IAAI,EAAE,GAAG,IAAI,YAAa,CAAC;IACjE,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,EAAE,GAAG,IAAI,YAAY,IAAI,yBAAyB,CAAC,OAAO,CAAC;IAErF,MAAM,GAAG,GAAG,OAAO,CACjB,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,EAAE;QACnD,GAAG,MAAM;QACT,YAAY;QACZ,UAAU;QACV,aAAa;QACb,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;KACpE,CAAC;IACF,6FAA6F;IAC7F,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CACrC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAC3E,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,wBAAwB,CAAC;YAC3B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,aAAa;YACb,0BAA0B,EAAE,MAAM,CAAC,0BAA0B,IAAI,EAAE;YACnE,oBAAoB,EAAE,EAAE,GAAG,MAAM,CAAC,oBAAoB,EAAE;YACxD,2BAA2B,EAAE,MAAM,CAAC,2BAA2B;YAC/D,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,CAAC,CAAC;QACH,QAAQ,CAAC,4BAA4B,EAAE,CAAC;IAC1C,CAAC,EAAE;QACD,QAAQ;QACR,GAAG;QACH,aAAa;QACb,MAAM,CAAC,0BAA0B;QACjC,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,2BAA2B;QAClC,MAAM,CAAC,gBAAgB;QACvB,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,cAAc;QACrB,MAAM,CAAC,gBAAgB;KACxB,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["/**\n * useResourceMutationManager Hook\n *\n * Separated from RMMRegistryContext.tsx for React Fast Refresh compatibility.\n *\n * Wraps RMMRegistry.getOrCreate + cleanup. Injects currentUserId from auth context.\n * Initial config is captured at first `getOrCreate`; a `useEffect` then calls\n * `syncRuntimeRoutingConfig` whenever routing/auth/conflict/CRDT semantics\n * change so reused instances stay aligned without remounting. `backpressure`\n * remains creation-time configuration for this low-level hook.\n */\n\nimport { useMemo, useEffect, useContext, useRef } from 'react';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { ResourceMutationManagerConfig } from './types';\n\nexport type UseRMMConfig = Omit<ResourceMutationManagerConfig, 'resourceType' | 'resourceId' | 'currentUserId'>;\n\n/**\n * Local helper — not extracted to its own file because only this hook needs\n * raw registry access. If other hooks need it later, extract to a separate file.\n */\nfunction useRMMRegistry() {\n  const registry = useContext(RMMRegistryContext);\n  if (!registry) throw new Error('useResourceMutationManager must be used within RMMRegistryProvider');\n  return registry;\n}\n\nexport function useResourceMutationManager(\n  resourceType: string,\n  resourceId: string,\n  config: UseRMMConfig,\n): ResourceMutationManager {\n  const registry = useRMMRegistry();\n  const { user, primaryScopeInitiatorIds } = useUserOrgs();\n  const scopedUserId = primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so the reused RMM runtime keeps a stable self-event identity.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = user?._id ?? scopedUserId!;\n  }\n  const currentUserId = user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n\n  const rmm = useMemo(\n    () => registry.getOrCreate(resourceType, resourceId, {\n      ...config,\n      resourceType,\n      resourceId,\n      currentUserId,\n      contextResourceIdentifiers: config.contextResourceIdentifiers ?? {},\n    }),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- config is immutable after creation\n    [registry, resourceType, resourceId],\n  );\n\n  useEffect(() => {\n    return () => registry.release(registry.keyFor(resourceType, resourceId));\n  }, [registry, resourceType, resourceId]);\n\n  useEffect(() => {\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter: config.transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: config.contextResourceIdentifiers ?? {},\n      contextualParameters: { ...config.contextualParameters },\n      parentResourcesRequirements: config.parentResourcesRequirements,\n      operationPathKey: config.operationPathKey,\n      readOperationPathKey: config.readOperationPathKey,\n      conflictPolicy: config.conflictPolicy,\n      resourceSchema: config.resourceSchema,\n    });\n    registry.notifyInstanceRuntimeChanged();\n  }, [\n    registry,\n    rmm,\n    currentUserId,\n    config.contextResourceIdentifiers,\n    config.contextualParameters,\n    config.parentResourcesRequirements,\n    config.operationPathKey,\n    config.readOperationPathKey,\n    config.conflictPolicy,\n    config.resourceSchema,\n    config.transportAdapter,\n  ]);\n\n  return rmm;\n}\n"]}

package/dist/esm/core/resources/rmm/useResourceRMM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceRMM.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAYtH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAiBlF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,cAAc,EAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC;IACxC,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,+BAA+B,GAAG,IAAI,CAAC;IAC7D,6BAA6B,EAAE,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,oBAAY,+BAA+B;IACzC;;;OAGG;IACH,gBAAgB,qBAAqB;IACrC;;;;OAIG;IACH,QAAQ,aAAa;IACrB;;;;OAIG;IACH,mBAAmB,wBAAwB;IAC3C;;;;;OAKG;IACH,4BAA4B,iCAAiC;CAC9D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAwPjF"}
+{"version":3,"file":"useResourceRMM.d.ts","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+DAA+D,CAAC;AAYtH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAiBlF,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,cAAc,EAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,2BAA2B,CAAC,EAAE,OAAO,EAAE,CAAC;IACxC,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,4BAA4B,CAAC,CAAC;IAC5F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,+BAA+B,GAAG,IAAI,CAAC;IAC7D,6BAA6B,EAAE,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,oBAAY,+BAA+B;IACzC;;;OAGG;IACH,gBAAgB,qBAAqB;IACrC;;;;OAIG;IACH,QAAQ,aAAa;IACrB;;;;OAIG;IACH,mBAAmB,wBAAwB;IAC3C;;;;;OAKG;IACH,4BAA4B,iCAAiC;CAC9D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAuPjF"}

package/dist/esm/core/resources/rmm/useResourceRMM.js

@@ -7,7 +7,7 @@ import { CoreResourceOperation, ResourcesConfig_OperationPathUtils, } from '@wil
 import { FrontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
 import { LoggerFrontendService } from '../../../core/monitoring/logger.frontend.service.js';
 import { getOperationsForCoreSemantic } from '../../../core/resources/operation-semantics.frontend.utils.js';
-import { pickPreferredOperationForCoreSemanticAddressability } from '../../../core/resources/resource-addressability.frontend.utils.js';
+import { pickInlineFieldWriteOperation } from '../../../core/resources/resource-addressability.frontend.utils.js';
 import { operationInitiatorParametersSatisfied } from '../../../core/resources/operation-initiator-satisfaction.frontend.utils.js';
 import { normalizeContextResourceIdentifiersForTransport } from '../../../core/resources/context-resource-identifiers.frontend.utils.js';
 import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
@@ -93,10 +93,9 @@ export function useResourceRMM(config) {
     // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref
     []);
     const updateOperation = useMemo(() => {
-        return pickPreferredOperationForCoreSemanticAddressability({
+        return pickInlineFieldWriteOperation({
             resourceConfig,
             operations: resourceConfig?.operations ?? [],
-            coreOperation: CoreResourceOperation.UPDATE,
             registry,
             hasResourceId: Boolean(resourceIdStr),
             contextResourceIdentifiers,

package/dist/esm/core/resources/rmm/useResourceRMM.js.map

@@ -1 +1 @@
-{"version":3,"file":"useResourceRMM.js","sourceRoot":"","sources":["../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared RMM lifecycle: registry lookup, transport adapter, getOrCreate, routing sync,\n * cleanup on unmount, snapshot subscription, and list invalidation.\n */\n\nimport { useContext, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport type { RefObject } from 'react';\nimport {\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { DoOperationFn } from './HttpTransportAdapter';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getOperationsForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickPreferredOperationForCoreSemanticAddressability } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport { operationInitiatorParametersSatisfied } from '~wildo-frontend-lib/core/resources/operation-initiator-satisfaction.frontend.utils';\nimport { normalizeContextResourceIdentifiersForTransport } from '~wildo-frontend-lib/core/resources/context-resource-identifiers.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { UserOrgsContext } from '~wildo-frontend-lib/core/security/UserOrgsContext';\nimport { HttpTransportAdapter } from './HttpTransportAdapter';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMRegistry } from './RMMRegistry';\nimport { ConflictStrategy, type ConflictPolicy, type RMMSnapshot } from './types';\nimport { resolveCanonicalRMMReadOperationPathKey } from './canonical-read.frontend.utils';\nimport { useListInvalidation } from './useListInvalidation';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useResourceRMM');\nlogger.setDebugTypeLogging('useResourceRMM', false);\n\n/**\n * Stable default conflict policy. As an inline default-parameter object literal it\n * would mint a fresh identity on every render; `conflictPolicy` is a dependency of\n * the routing-sync effect below, so a fresh identity re-fires that effect (and its\n * `rmmRegistry.notifyInstanceRuntimeChanged()`) on every commit even when nothing\n * changed. A module constant keeps the default referentially stable.\n */\nconst DEFAULT_CONFLICT_POLICY: ConflictPolicy = { strategy: ConflictStrategy.ACCEPT_REMOTE };\n\nexport interface UseResourceRMMConfig {\n  resourceType: string;\n  /** When falsy, RMM is not attached (e.g. CREATE flow or missing id). */\n  resourceId: string | null | undefined;\n  doOperationRef: RefObject<DoOperationFn | null>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  resourceSchema?: unknown;\n  /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n}\n\nexport interface UseResourceRMMResult {\n  rmm: ResourceMutationManager | null;\n  rmmSnapshot: RMMSnapshot;\n  rmmRegistry: RMMRegistry | null;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  canonicalReadOperationPathKey: string | undefined;\n}\n\n/**\n * Why RMM is unattached for the current surface. Every reason fails closed\n * (`rmm === null`); the reason only drives diagnostics. Two of the reasons\n * are *expected absences* logged at debug, two are *genuine integration\n * failures* logged at warn — see the classification memo in\n * `useResourceRMM` for the precedence rules that keep expected absences out\n * of the loud lane.\n */\nexport enum UseResourceRMMUnavailableReason {\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id resolved an operation but no `RMMRegistryProvider` is mounted above it.\n   */\n  PROVIDER_MISSING = 'PROVIDER_MISSING',\n  /**\n   * Expected absence (debug): the caller explicitly opted out of RMM\n   * attachment (e.g. `enabled: isUpdateLikeOperation && !!resourceId` on a\n   * CREATE form).\n   */\n  DISABLED = 'DISABLED',\n  /**\n   * Expected absence (debug): no persisted resource id is attached yet\n   * (CREATE flow, parent-context singleton awaiting READ bootstrap). RMM is\n   * keyed by resource id and can never attach without one.\n   */\n  MISSING_RESOURCE_ID = 'MISSING_RESOURCE_ID',\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id could not resolve any eligible UPDATE-like operation. Default\n   * update-like surfaces fail closed on this unless they explicitly opt\n   * into a weaker direct-operation fallback.\n   */\n  NO_ELIGIBLE_UPDATE_OPERATION = 'NO_ELIGIBLE_UPDATE_OPERATION',\n}\n\nexport function useResourceRMM(config: UseResourceRMMConfig): UseResourceRMMResult {\n  const {\n    resourceType,\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers,\n    resourceSchema,\n    enabled = true,\n    conflictPolicy = DEFAULT_CONFLICT_POLICY,\n  } = config;\n\n  const rmmRegistry = useContext(RMMRegistryContext);\n  const { registry } = useResourceRegistry();\n  const userOrgs = useContext(UserOrgsContext);\n  const scopedUserId = userOrgs?.primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so same-user websocket replay does not immediately degrade into the\n  // foreign-remote lane during runtime churn.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (userOrgs?.user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = userOrgs?.user?._id ?? scopedUserId!;\n  }\n  const currentUserId = userOrgs?.user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n\n  const contextResourceIdentifiersKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(contextResourceIdentifiers),\n    [contextResourceIdentifiers],\n  );\n  // Content-stable key for the routing-sync effect dependency below.\n  // `parentResourcesRequirements` arrives as a freshly-allocated array on most\n  // renders (callers build it inline, e.g. `buildParentResourcesRequirements(...)`),\n  // so depending on its *identity* re-fires the sync effect — and its\n  // `rmmRegistry.notifyInstanceRuntimeChanged()` — on every commit even when the\n  // requirements are unchanged, which storms the WebSocket room re-subscription.\n  // Keying by content mirrors `contextResourceIdentifiersKey`.\n  const parentResourcesRequirementsKey = useMemo(\n    () => JSON.stringify(parentResourcesRequirements ?? null),\n    [parentResourcesRequirements],\n  );\n  const resourceIdStr = resourceId ? String(resourceId) : '';\n\n  const transportAdapter = useMemo(\n    () => new HttpTransportAdapter((...args) => doOperationRef.current!(...args)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref\n    [],\n  );\n\n  const updateOperation = useMemo(() => {\n    return pickPreferredOperationForCoreSemanticAddressability({\n      resourceConfig,\n      operations: resourceConfig?.operations ?? [],\n      coreOperation: CoreResourceOperation.UPDATE,\n      registry,\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig, resourceIdStr]);\n\n  const rmmOperationPathKey = useMemo(() => {\n    if (!updateOperation) {\n      return null;\n    }\n\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n  }, [resourceType, updateOperation]);\n\n  const rmmReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig?.operations, resourceIdStr, resourceType]);\n\n  const listOperations = useMemo(\n    () => {\n      const { [resourceType]: _self, ...parentScopeIdentifiers } = contextResourceIdentifiers ?? {};\n      const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(\n        parentScopeIdentifiers,\n        registry,\n      );\n      return getOperationsForCoreSemantic(\n        resourceConfig?.operations ?? [],\n        CoreResourceOperation.LIST,\n      ).filter((listOperation) =>\n        operationInitiatorParametersSatisfied({\n          operation: listOperation,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          contextualParameters: parentContextualParameters,\n        })\n      );\n    },\n    [contextResourceIdentifiersKey, registry, resourceConfig?.operations, resourceType],\n  );\n\n  /**\n   * Classify why RMM is unattached, expected-absence checks first. The\n   * precedence matters because the reason drives log level downstream:\n   * `DISABLED` / `MISSING_RESOURCE_ID` are expected absences (debug),\n   * `NO_ELIGIBLE_UPDATE_OPERATION` / `PROVIDER_MISSING` are genuine\n   * integration failures (warn).\n   *\n   * - `!enabled` always classifies as DISABLED, even when no update\n   *   operation resolves: the caller explicitly opted out (the form /\n   *   displayer / layout callers gate `enabled` on `<update-like> && <has\n   *   id>`; the execution participation bridge gates it on execution-level\n   *   availability), so a CREATE surface must not be reported as an\n   *   operation-eligibility failure.\n   * - The missing-id check runs before operation eligibility: without an id\n   *   RMM can never attach (the registry is keyed by resource id), and\n   *   UPDATE addressability is resolved with `hasResourceId: false`, so an\n   *   unresolved operation on an id-less surface is the expected CREATE /\n   *   pre-bootstrap shape rather than a broken update-like surface.\n   *\n   * Rejected alternative: keeping the old loud-first order and only\n   * downgrading the log level — that would still misreport create-like\n   * surfaces as `NO_ELIGIBLE_UPDATE_OPERATION` to consumers of\n   * `rmmUnavailableReason`. All reasons keep failing closed (rmm === null);\n   * only classification and log level differ.\n   */\n  const rmmUnavailableReason = useMemo((): UseResourceRMMUnavailableReason | null => {\n    if (!enabled) {\n      return UseResourceRMMUnavailableReason.DISABLED;\n    }\n    if (!resourceIdStr) {\n      return UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID;\n    }\n    if (!updateOperation) {\n      return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;\n    }\n    if (!rmmRegistry) {\n      return UseResourceRMMUnavailableReason.PROVIDER_MISSING;\n    }\n\n    return null;\n  }, [enabled, resourceIdStr, rmmRegistry, updateOperation]);\n\n  const rmm = useMemo(() => {\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.DISABLED) {\n      logDebug('RMM unavailable because attachment is disabled for this surface.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {\n      logDebug('RMM unavailable because no resource id is attached to the current surface.', {\n        resourceType,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {\n      logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.PROVIDER_MISSING) {\n      logger.warn('[useResourceRMM] RMM unavailable because RMMRegistryProvider is not mounted. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n    return rmmRegistry.getOrCreate(resourceType, resourceIdStr, {\n      resourceType,\n      resourceId: resourceIdStr,\n      transportAdapter,\n      operationPathKey: rmmOperationPathKey!,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      resourceSchema,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- registry identity + sync effect for routing/auth\n  }, [rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);\n\n  useEffect(() => {\n    if (!rmm || !rmmOperationPathKey) return;\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      operationPathKey: rmmOperationPathKey,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      resourceSchema,\n    });\n    rmmRegistry?.notifyInstanceRuntimeChanged();\n  }, [\n    rmm,\n    rmmRegistry,\n    currentUserId,\n    // `ConflictPolicy` is `{ strategy }`; depend on the strategy value, not the\n    // (commonly inline, fresh-identity) object literal callers pass, so the sync\n    // effect does not re-fire — and re-notify — on every commit.\n    conflictPolicy.strategy,\n    contextResourceIdentifiersKey,\n    rmmOperationPathKey,\n    rmmReadOperationPathKey,\n    parentResourcesRequirementsKey,\n    contextualParameters,\n    resourceSchema,\n    transportAdapter,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !rmmRegistry || !resourceIdStr) {\n      return;\n    }\n\n    const key = rmmRegistry.keyFor(resourceType, resourceIdStr);\n    return () => {\n      rmmRegistry.release(key);\n    };\n  }, [rmm, rmmRegistry, resourceType, resourceIdStr]);\n\n  const rmmSnapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n\n  useListInvalidation(rmm, {\n    contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n    parentResourcesRequirements: parentResourcesRequirements ?? [],\n    listOperations,\n  });\n\n  return {\n    rmm,\n    rmmSnapshot,\n    rmmRegistry: rmmRegistry ?? null,\n    rmmUnavailableReason,\n    canonicalReadOperationPathKey: rmmReadOperationPathKey,\n  };\n}\n"]}
+{"version":3,"file":"useResourceRMM.js","sourceRoot":"","sources":["../../../../../../src/core/resources/rmm/useResourceRMM.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared RMM lifecycle: registry lookup, transport adapter, getOrCreate, routing sync,\n * cleanup on unmount, snapshot subscription, and list invalidation.\n */\n\nimport { useContext, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport type { RefObject } from 'react';\nimport {\n  CoreResourceOperation,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n} from '@wildo-ai/saas-models';\nimport type { DoOperationFn } from './HttpTransportAdapter';\nimport type { FrontendResourceOperationContext } from '~wildo-frontend-lib/core/resources/resources.frontend.schemas';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getOperationsForCoreSemantic } from '~wildo-frontend-lib/core/resources/operation-semantics.frontend.utils';\nimport { pickInlineFieldWriteOperation } from '~wildo-frontend-lib/core/resources/resource-addressability.frontend.utils';\nimport { operationInitiatorParametersSatisfied } from '~wildo-frontend-lib/core/resources/operation-initiator-satisfaction.frontend.utils';\nimport { normalizeContextResourceIdentifiersForTransport } from '~wildo-frontend-lib/core/resources/context-resource-identifiers.frontend.utils';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { UserOrgsContext } from '~wildo-frontend-lib/core/security/UserOrgsContext';\nimport { HttpTransportAdapter } from './HttpTransportAdapter';\nimport { NOOP_GET_SNAPSHOT, NOOP_SUBSCRIBE } from './rmm-noop-snapshot';\nimport { RMMRegistryContext } from './RMMRegistryContext';\nimport type { ResourceMutationManager } from './ResourceMutationManager';\nimport type { RMMRegistry } from './RMMRegistry';\nimport { ConflictStrategy, type ConflictPolicy, type RMMSnapshot } from './types';\nimport { resolveCanonicalRMMReadOperationPathKey } from './canonical-read.frontend.utils';\nimport { useListInvalidation } from './useListInvalidation';\n\nconst logger = LoggerFrontendService.getLogger();\nconst logDebug = logger.debugByType('useResourceRMM');\nlogger.setDebugTypeLogging('useResourceRMM', false);\n\n/**\n * Stable default conflict policy. As an inline default-parameter object literal it\n * would mint a fresh identity on every render; `conflictPolicy` is a dependency of\n * the routing-sync effect below, so a fresh identity re-fires that effect (and its\n * `rmmRegistry.notifyInstanceRuntimeChanged()`) on every commit even when nothing\n * changed. A module constant keeps the default referentially stable.\n */\nconst DEFAULT_CONFLICT_POLICY: ConflictPolicy = { strategy: ConflictStrategy.ACCEPT_REMOTE };\n\nexport interface UseResourceRMMConfig {\n  resourceType: string;\n  /** When falsy, RMM is not attached (e.g. CREATE flow or missing id). */\n  resourceId: string | null | undefined;\n  doOperationRef: RefObject<DoOperationFn | null>;\n  contextualParameters: Record<string, string | number>;\n  parentResourcesRequirements?: unknown[];\n  contextResourceIdentifiers?: FrontendResourceOperationContext['contextResourceIdentifiers'];\n  resourceSchema?: unknown;\n  /** When false, skip RMM entirely (e.g. non–UPDATE-like form or resource without UPDATE). */\n  enabled?: boolean;\n  conflictPolicy?: ConflictPolicy;\n}\n\nexport interface UseResourceRMMResult {\n  rmm: ResourceMutationManager | null;\n  rmmSnapshot: RMMSnapshot;\n  rmmRegistry: RMMRegistry | null;\n  rmmUnavailableReason: UseResourceRMMUnavailableReason | null;\n  canonicalReadOperationPathKey: string | undefined;\n}\n\n/**\n * Why RMM is unattached for the current surface. Every reason fails closed\n * (`rmm === null`); the reason only drives diagnostics. Two of the reasons\n * are *expected absences* logged at debug, two are *genuine integration\n * failures* logged at warn — see the classification memo in\n * `useResourceRMM` for the precedence rules that keep expected absences out\n * of the loud lane.\n */\nexport enum UseResourceRMMUnavailableReason {\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id resolved an operation but no `RMMRegistryProvider` is mounted above it.\n   */\n  PROVIDER_MISSING = 'PROVIDER_MISSING',\n  /**\n   * Expected absence (debug): the caller explicitly opted out of RMM\n   * attachment (e.g. `enabled: isUpdateLikeOperation && !!resourceId` on a\n   * CREATE form).\n   */\n  DISABLED = 'DISABLED',\n  /**\n   * Expected absence (debug): no persisted resource id is attached yet\n   * (CREATE flow, parent-context singleton awaiting READ bootstrap). RMM is\n   * keyed by resource id and can never attach without one.\n   */\n  MISSING_RESOURCE_ID = 'MISSING_RESOURCE_ID',\n  /**\n   * Genuine failure (warn): an enabled update-like surface with a resource\n   * id could not resolve any eligible UPDATE-like operation. Default\n   * update-like surfaces fail closed on this unless they explicitly opt\n   * into a weaker direct-operation fallback.\n   */\n  NO_ELIGIBLE_UPDATE_OPERATION = 'NO_ELIGIBLE_UPDATE_OPERATION',\n}\n\nexport function useResourceRMM(config: UseResourceRMMConfig): UseResourceRMMResult {\n  const {\n    resourceType,\n    resourceId,\n    doOperationRef,\n    contextualParameters,\n    parentResourcesRequirements,\n    contextResourceIdentifiers,\n    resourceSchema,\n    enabled = true,\n    conflictPolicy = DEFAULT_CONFLICT_POLICY,\n  } = config;\n\n  const rmmRegistry = useContext(RMMRegistryContext);\n  const { registry } = useResourceRegistry();\n  const userOrgs = useContext(UserOrgsContext);\n  const scopedUserId = userOrgs?.primaryScopeInitiatorIds?.userId ?? null;\n  // Preserve the last known authenticated user id across transient auth-context\n  // dropouts so same-user websocket replay does not immediately degrade into the\n  // foreign-remote lane during runtime churn.\n  const lastKnownCurrentUserIdRef = useRef<string>('');\n  if (userOrgs?.user?._id || scopedUserId) {\n    lastKnownCurrentUserIdRef.current = userOrgs?.user?._id ?? scopedUserId!;\n  }\n  const currentUserId = userOrgs?.user?._id ?? scopedUserId ?? lastKnownCurrentUserIdRef.current;\n  const resourceConfig = registry.resourceConfigurations[resourceType];\n\n  const contextResourceIdentifiersKey = useMemo(\n    () => FrontendResourceUtils.buildContextResourceIdentifiersKey(contextResourceIdentifiers),\n    [contextResourceIdentifiers],\n  );\n  // Content-stable key for the routing-sync effect dependency below.\n  // `parentResourcesRequirements` arrives as a freshly-allocated array on most\n  // renders (callers build it inline, e.g. `buildParentResourcesRequirements(...)`),\n  // so depending on its *identity* re-fires the sync effect — and its\n  // `rmmRegistry.notifyInstanceRuntimeChanged()` — on every commit even when the\n  // requirements are unchanged, which storms the WebSocket room re-subscription.\n  // Keying by content mirrors `contextResourceIdentifiersKey`.\n  const parentResourcesRequirementsKey = useMemo(\n    () => JSON.stringify(parentResourcesRequirements ?? null),\n    [parentResourcesRequirements],\n  );\n  const resourceIdStr = resourceId ? String(resourceId) : '';\n\n  const transportAdapter = useMemo(\n    () => new HttpTransportAdapter((...args) => doOperationRef.current!(...args)),\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- doOperationRef is a stable ref\n    [],\n  );\n\n  const updateOperation = useMemo(() => {\n    return pickInlineFieldWriteOperation({\n      resourceConfig,\n      operations: resourceConfig?.operations ?? [],\n      registry,\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig, resourceIdStr]);\n\n  const rmmOperationPathKey = useMemo(() => {\n    if (!updateOperation) {\n      return null;\n    }\n\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(updateOperation);\n  }, [resourceType, updateOperation]);\n\n  const rmmReadOperationPathKey = useMemo(() => {\n    return resolveCanonicalRMMReadOperationPathKey(resourceType, registry, {\n      hasResourceId: Boolean(resourceIdStr),\n      contextResourceIdentifiers,\n      contextualParameters,\n    });\n  }, [contextResourceIdentifiersKey, contextualParameters, registry, resourceConfig?.operations, resourceIdStr, resourceType]);\n\n  const listOperations = useMemo(\n    () => {\n      const { [resourceType]: _self, ...parentScopeIdentifiers } = contextResourceIdentifiers ?? {};\n      const parentContextualParameters = FrontendResourceUtils.buildContextualParameters(\n        parentScopeIdentifiers,\n        registry,\n      );\n      return getOperationsForCoreSemantic(\n        resourceConfig?.operations ?? [],\n        CoreResourceOperation.LIST,\n      ).filter((listOperation) =>\n        operationInitiatorParametersSatisfied({\n          operation: listOperation,\n          contextResourceIdentifiers: parentScopeIdentifiers,\n          contextualParameters: parentContextualParameters,\n        })\n      );\n    },\n    [contextResourceIdentifiersKey, registry, resourceConfig?.operations, resourceType],\n  );\n\n  /**\n   * Classify why RMM is unattached, expected-absence checks first. The\n   * precedence matters because the reason drives log level downstream:\n   * `DISABLED` / `MISSING_RESOURCE_ID` are expected absences (debug),\n   * `NO_ELIGIBLE_UPDATE_OPERATION` / `PROVIDER_MISSING` are genuine\n   * integration failures (warn).\n   *\n   * - `!enabled` always classifies as DISABLED, even when no update\n   *   operation resolves: the caller explicitly opted out (the form /\n   *   displayer / layout callers gate `enabled` on `<update-like> && <has\n   *   id>`; the execution participation bridge gates it on execution-level\n   *   availability), so a CREATE surface must not be reported as an\n   *   operation-eligibility failure.\n   * - The missing-id check runs before operation eligibility: without an id\n   *   RMM can never attach (the registry is keyed by resource id), and\n   *   UPDATE addressability is resolved with `hasResourceId: false`, so an\n   *   unresolved operation on an id-less surface is the expected CREATE /\n   *   pre-bootstrap shape rather than a broken update-like surface.\n   *\n   * Rejected alternative: keeping the old loud-first order and only\n   * downgrading the log level — that would still misreport create-like\n   * surfaces as `NO_ELIGIBLE_UPDATE_OPERATION` to consumers of\n   * `rmmUnavailableReason`. All reasons keep failing closed (rmm === null);\n   * only classification and log level differ.\n   */\n  const rmmUnavailableReason = useMemo((): UseResourceRMMUnavailableReason | null => {\n    if (!enabled) {\n      return UseResourceRMMUnavailableReason.DISABLED;\n    }\n    if (!resourceIdStr) {\n      return UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID;\n    }\n    if (!updateOperation) {\n      return UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION;\n    }\n    if (!rmmRegistry) {\n      return UseResourceRMMUnavailableReason.PROVIDER_MISSING;\n    }\n\n    return null;\n  }, [enabled, resourceIdStr, rmmRegistry, updateOperation]);\n\n  const rmm = useMemo(() => {\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.DISABLED) {\n      logDebug('RMM unavailable because attachment is disabled for this surface.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.MISSING_RESOURCE_ID) {\n      logDebug('RMM unavailable because no resource id is attached to the current surface.', {\n        resourceType,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.NO_ELIGIBLE_UPDATE_OPERATION) {\n      logger.warn('[useResourceRMM] RMM unavailable because no eligible UPDATE-like operation could be resolved for this surface. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n\n    if (rmmUnavailableReason === UseResourceRMMUnavailableReason.PROVIDER_MISSING) {\n      logger.warn('[useResourceRMM] RMM unavailable because RMMRegistryProvider is not mounted. Default update-like surfaces should fail closed unless they explicitly opt into a weaker direct-operation fallback.', {\n        resourceType,\n        resourceId: resourceIdStr,\n      });\n      return null;\n    }\n    return rmmRegistry.getOrCreate(resourceType, resourceIdStr, {\n      resourceType,\n      resourceId: resourceIdStr,\n      transportAdapter,\n      operationPathKey: rmmOperationPathKey!,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      resourceSchema,\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- registry identity + sync effect for routing/auth\n  }, [rmmOperationPathKey, rmmReadOperationPathKey, rmmRegistry, resourceType, resourceIdStr, rmmUnavailableReason]);\n\n  useEffect(() => {\n    if (!rmm || !rmmOperationPathKey) return;\n    rmm.syncRuntimeRoutingConfig({\n      transportAdapter,\n      currentUserId,\n      contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n      contextualParameters,\n      parentResourcesRequirements,\n      operationPathKey: rmmOperationPathKey,\n      readOperationPathKey: rmmReadOperationPathKey,\n      conflictPolicy,\n      resourceSchema,\n    });\n    rmmRegistry?.notifyInstanceRuntimeChanged();\n  }, [\n    rmm,\n    rmmRegistry,\n    currentUserId,\n    // `ConflictPolicy` is `{ strategy }`; depend on the strategy value, not the\n    // (commonly inline, fresh-identity) object literal callers pass, so the sync\n    // effect does not re-fire — and re-notify — on every commit.\n    conflictPolicy.strategy,\n    contextResourceIdentifiersKey,\n    rmmOperationPathKey,\n    rmmReadOperationPathKey,\n    parentResourcesRequirementsKey,\n    contextualParameters,\n    resourceSchema,\n    transportAdapter,\n  ]);\n\n  useEffect(() => {\n    if (!rmm || !rmmRegistry || !resourceIdStr) {\n      return;\n    }\n\n    const key = rmmRegistry.keyFor(resourceType, resourceIdStr);\n    return () => {\n      rmmRegistry.release(key);\n    };\n  }, [rmm, rmmRegistry, resourceType, resourceIdStr]);\n\n  const rmmSnapshot = useSyncExternalStore(\n    rmm?.subscribe ?? NOOP_SUBSCRIBE,\n    rmm?.getSnapshot ?? NOOP_GET_SNAPSHOT,\n  );\n\n  useListInvalidation(rmm, {\n    contextResourceIdentifiers: normalizeContextResourceIdentifiersForTransport(contextResourceIdentifiers),\n    parentResourcesRequirements: parentResourcesRequirements ?? [],\n    listOperations,\n  });\n\n  return {\n    rmm,\n    rmmSnapshot,\n    rmmRegistry: rmmRegistry ?? null,\n    rmmUnavailableReason,\n    canonicalReadOperationPathKey: rmmReadOperationPathKey,\n  };\n}\n"]}

package/dist/esm/core/resources/useAuthedFileObjectUrl.frontend.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.d.ts","sourceRoot":"","sources":["../../../../src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAkBA,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CA8BzF"}
+{"version":3,"file":"useAuthedFileObjectUrl.frontend.hook.d.ts","sourceRoot":"","sources":["../../../../../src/core/resources/useAuthedFileObjectUrl.frontend.hook.ts"],"names":[],"mappings":"AAkBA,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CA8BzF"}