sequence-id

This module returns the same id for matching sequence payloads in a specific context object. When the same context and sequence are used again, rs-x reuses the same sequence-id handle.

create(context, sequence) creates or reuses a handle. get(context, sequence) only reads an existing handle. release(context, id) releases one reference for that handle.

The default singleton service is SequenceIdFactory, resolved through RsXCoreInjectionTokens.ISequenceIdFactory. If you call create, call dispose() on the returned handle (or call release) when finished to prevent memory leaks.

import {
  Inject,
  RsXCoreInjectionTokens,
  type ISequenceIdFactory,
} from '@rs-x/core';

class SequenceConsumer {
  constructor(
    @Inject(RsXCoreInjectionTokens.ISequenceIdFactory)
    private readonly sequenceIdFactory: ISequenceIdFactory,
  ) {}

  track(context: object, path: unknown[]): string {
    const handle = this.sequenceIdFactory.create(context, path);
    try {
      return handle.id;
    } finally {
      handle.dispose();
    }
  }
}

• IISequenceWithIdDatainterfaceData shape that pairs a sequence payload with its id.→
• ISequenceIdFactoryinterfaceService that returns the same id handle for the same sequence in a given context, reuses existing handles for matching input, and releases them when no longer needed. Always dispose/release handles when finished to prevent memory leaks.→
• ISequenceWithIdinterfaceRepresents one sequence payload and its generated id, with dispose support. Always call dispose() when finished to prevent memory leaks.→
• SequenceIdFactoryclassDefault singleton service that returns the same sequence id per context for matching input, reuses handles, and tracks references. Always release/dispose handles when finished to prevent memory leaks.→
• SequenceWithIdclassDefault sequence-id handle containing the source sequence and generated id. Always call dispose() when finished to prevent memory leaks.→