package Net::XMPP2::Extendable;
use warnings;
use strict;

=head1 NAME

Net::XMPP2::Extendable - Extendable baseclass

=head1 DESCRIPTION

This class provides a mechanism to add extensions.
Please note that the class that derives from this must also
derive from L<Net::XMPP2::Event>!

Please see L<Net::XMPP2::Ext> for more information about this mechanism.

=over 4

=item B<add_extension ($ext)>

This method extends the current object with a L<Net::XMPP2::Ext> object.
C<$ext> must be an instance of L<Net::XMPP2::Ext>.

=cut

sub add_extension {
   my ($self, $ext) = @_;
   $self->add_forward ($ext, sub {
      my ($self, $ext, $ev, @args) = @_;
      $ext->event ($ev, $self, @args);
   });
}

=item B<remove_extension ($ext)>

This method removes the extension C<$ext>.

=cut

sub remove_extension {
   my ($self, $ext) = @_;
   $self->remove_forward ($ext);
}

=item B<disco_features>

This method can be overwritten by the extension and should return
a list of namespace URIs of the features that the extension enables.

=cut

sub disco_features { }

=back

=head1 AUTHOR

Robin Redeker, C<< <elmex at ta-sa.org> >>, JID: C<< <elmex at jabber.org> >>

=head1 COPYRIGHT & LICENSE

Copyright 2007 Robin Redeker, all rights reserved.

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

=cut

1; # End of Net::XMPP2