MT#7067 API: Implement sound file handling.

Create new sound files.
Update sound files.
Delete sound files.

lib/NGCP/Panel/Controller/API/SoundFileRecordings.pm

@@ -0,0 +1,78 @@
+package NGCP::Panel::Controller::API::SoundFileRecordings;
+use Sipwise::Base;
+use namespace::sweep;
+use boolean qw(true);
+use Data::HAL qw();
+use Data::HAL::Link qw();
+use HTTP::Headers qw();
+use HTTP::Status qw(:constants);
+use MooseX::ClassAttribute qw(class_has);
+use NGCP::Panel::Utils::DateTime;
+use Path::Tiny qw(path);
+use Safe::Isa qw($_isa);
+BEGIN { extends 'Catalyst::Controller::ActionRole'; }
+require Catalyst::ActionRole::ACL;
+require Catalyst::ActionRole::CheckTrailingSlash;
+require Catalyst::ActionRole::HTTPMethods;
+require Catalyst::ActionRole::RequireSSL;
+
+class_has 'api_description' => (
+    is => 'ro',
+    isa => 'Str',
+    default => 
+        'Defines the actual recording of sound files.',
+);
+
+class_has 'query_params' => (
+    is => 'ro',
+    isa => 'ArrayRef',
+    default => sub {[
+    ]},
+);
+
+with 'NGCP::Panel::Role::API::SoundFiles';
+
+class_has('resource_name', is => 'ro', default => 'soundfilerecordings');
+class_has('dispatch_path', is => 'ro', default => '/api/soundfilerecordings/');
+class_has('relation', is => 'ro', default => 'http://purl.org/sipwise/ngcp-api/#rel-soundfilerecordings');
+
+__PACKAGE__->config(
+    action => {
+        map { $_ => {
+            ACLDetachTo => '/api/root/invalid_user',
+            AllowedRole => [qw/admin reseller/],
+            Args => 0,
+            Does => [qw(ACL CheckTrailingSlash RequireSSL)],
+            Method => $_,
+            Path => __PACKAGE__->dispatch_path,
+        } } @{ __PACKAGE__->allowed_methods }
+    },
+    action_roles => [qw(HTTPMethods)],
+);
+
+sub auto :Private {
+    my ($self, $c) = @_;
+
+    $self->set_body($c);
+    #$self->log_request($c);
+}
+
+sub OPTIONS :Allow {
+    my ($self, $c) = @_;
+    my $allowed_methods = $self->allowed_methods;
+    $c->response->headers(HTTP::Headers->new(
+        Allow => $allowed_methods->join(', '),
+        Accept_Post => 'application/hal+json; profile=http://purl.org/sipwise/ngcp-api/#rel-'.$self->resource_name,
+    ));
+    $c->response->content_type('application/json');
+    $c->response->body(JSON::to_json({ methods => $allowed_methods })."\n");
+    return;
+}
+
+sub end : Private {
+    my ($self, $c) = @_;
+
+    $self->log_response($c);
+}
+
+# vim: set tabstop=4 expandtab:

lib/NGCP/Panel/Controller/API/SoundFileRecordingsItem.pm

@@ -0,0 +1,91 @@
+package NGCP::Panel::Controller::API::SoundFileRecordingsItem;
+use Sipwise::Base;
+use namespace::sweep;
+use HTTP::Headers qw();
+use HTTP::Status qw(:constants);
+use MooseX::ClassAttribute qw(class_has);
+use NGCP::Panel::Utils::DateTime;
+use NGCP::Panel::Utils::ValidateJSON qw();
+use Path::Tiny qw(path);
+use Safe::Isa qw($_isa);
+BEGIN { extends 'Catalyst::Controller::ActionRole'; }
+require Catalyst::ActionRole::ACL;
+require Catalyst::ActionRole::HTTPMethods;
+require Catalyst::ActionRole::RequireSSL;
+
+with 'NGCP::Panel::Role::API::SoundFiles';
+
+class_has('resource_name', is => 'ro', default => 'soundfilerecordings');
+class_has('dispatch_path', is => 'ro', default => '/api/soundfilerecordings/');
+class_has('relation', is => 'ro', default => 'http://purl.org/sipwise/ngcp-api/#rel-soundfilerecordings');
+
+__PACKAGE__->config(
+    action => {
+        map { $_ => {
+            ACLDetachTo => '/api/root/invalid_user',
+            AllowedRole => [qw/admin reseller/],
+            Args => 1,
+            Does => [qw(ACL RequireSSL)],
+            Method => $_,
+            Path => __PACKAGE__->dispatch_path,
+        } } @{ __PACKAGE__->allowed_methods }
+    },
+    action_roles => [qw(HTTPMethods)],
+);
+
+sub auto :Private {
+    my ($self, $c) = @_;
+
+    $self->set_body($c);
+    $self->log_request($c);
+}
+
+sub GET :Allow {
+    my ($self, $c, $id) = @_;
+    {
+        last unless $self->valid_id($c, $id);
+        my $item = $self->item_by_id($c, $id);
+        last unless $self->resource_exists($c, soundfilerecording => $item);
+        my $resource = $self->resource_from_item($c, $item);
+
+        $resource->{data} = $item->data;
+        if($item->codec eq "PCMA") {
+            $resource->{codec} = 'WAV';
+            $resource = $self->transcode_data($c, $item->codec, $resource);
+            last unless($resource);
+        }
+
+        $c->response->header ('Content-Disposition' => 'attachment; filename="' . $resource->{filename} . '"');
+        $c->response->content_type('audio/x-wav');
+        $c->response->body($resource->{data});
+        return;
+    }
+    return;
+}
+
+sub HEAD :Allow {
+    my ($self, $c, $id) = @_;
+    $c->forward(qw(GET));
+    $c->response->body(q());
+    return;
+}
+
+sub OPTIONS :Allow {
+    my ($self, $c, $id) = @_;
+    my $allowed_methods = $self->allowed_methods;
+    $c->response->headers(HTTP::Headers->new(
+        Allow => $allowed_methods->join(', '),
+        Accept_Patch => 'application/json-patch+json',
+    ));
+    $c->response->content_type('application/json');
+    $c->response->body(JSON::to_json({ methods => $allowed_methods })."\n");
+    return;
+}
+
+sub end : Private {
+    my ($self, $c) = @_;
+
+    #$self->log_response($c);
+}
+
+# vim: set tabstop=4 expandtab:

lib/NGCP/Panel/Controller/API/SoundFiles.pm

@@ -0,0 +1,246 @@
+package NGCP::Panel::Controller::API::SoundFiles;
+use Sipwise::Base;
+use namespace::sweep;
+use boolean qw(true);
+use Data::HAL qw();
+use Data::HAL::Link qw();
+use HTTP::Headers qw();
+use HTTP::Status qw(:constants);
+use MooseX::ClassAttribute qw(class_has);
+use NGCP::Panel::Utils::DateTime;
+use Path::Tiny qw(path);
+use Safe::Isa qw($_isa);
+BEGIN { extends 'Catalyst::Controller::ActionRole'; }
+require Catalyst::ActionRole::ACL;
+require Catalyst::ActionRole::CheckTrailingSlash;
+require Catalyst::ActionRole::HTTPMethods;
+require Catalyst::ActionRole::RequireSSL;
+
+class_has 'api_description' => (
+    is => 'ro',
+    isa => 'Str',
+    default => 
+        'Defines sound files for system and customer sound sets. To create or update a sound file, do a POST or PUT with Content-Type audio/x-wav and pass the properties via query parameters, e.g. <span>/api/soundfiles/?set_id=1&amp;filename=test.wav&amp;loopplay=true&amp;handle=music_on_hold</span>',
+);
+
+class_has 'query_params' => (
+    is => 'ro',
+    isa => 'ArrayRef',
+    default => sub {[
+        {
+            param => 'set_id',
+            description => 'Filter for sound files of a specific sound set',
+            query => {
+                first => sub {
+                    my $q = shift;
+                    return { 'set_id' => $q };
+                },
+                second => sub { },
+            },
+        },
+    ]},
+);
+
+with 'NGCP::Panel::Role::API::SoundFiles';
+
+class_has('resource_name', is => 'ro', default => 'soundfiles');
+class_has('dispatch_path', is => 'ro', default => '/api/soundfiles/');
+class_has('relation', is => 'ro', default => 'http://purl.org/sipwise/ngcp-api/#rel-soundfiles');
+
+__PACKAGE__->config(
+    action => {
+        map { $_ => {
+            ACLDetachTo => '/api/root/invalid_user',
+            AllowedRole => [qw/admin reseller/],
+            Args => 0,
+            Does => [qw(ACL CheckTrailingSlash RequireSSL)],
+            Method => $_,
+            Path => __PACKAGE__->dispatch_path,
+        } } @{ __PACKAGE__->allowed_methods }
+    },
+    action_roles => [qw(HTTPMethods)],
+);
+
+sub auto :Private {
+    my ($self, $c) = @_;
+
+    $self->set_body($c);
+    $self->log_request($c);
+}
+
+sub GET :Allow {
+    my ($self, $c) = @_;
+    my $page = $c->request->params->{page} // 1;
+    my $rows = $c->request->params->{rows} // 10;
+    {
+        my $items = $self->item_rs($c);
+        my $total_count = int($items->count);
+        $items = $items->search(undef, {
+            page => $page,
+            rows => $rows,
+        });
+        my (@embedded, @links);
+        my $form = $self->get_form($c);
+        for my $item ($items->search({}, {order_by => {-asc => 'me.id'}})->all) {
+            push @embedded, $self->hal_from_item($c, $item, $form);
+            push @links, Data::HAL::Link->new(
+                relation => 'ngcp:'.$self->resource_name,
+                href     => sprintf('/%s%d', $c->request->path, $item->id),
+            );
+        }
+        push @links,
+            Data::HAL::Link->new(
+                relation => 'curies',
+                href => 'http://purl.org/sipwise/ngcp-api/#rel-{rel}',
+                name => 'ngcp',
+                templated => true,
+            ),
+            Data::HAL::Link->new(relation => 'profile', href => 'http://purl.org/sipwise/ngcp-api/'),
+            Data::HAL::Link->new(relation => 'self', href => sprintf('/%s?page=%s&rows=%s', $c->request->path, $page, $rows));
+        if(($total_count / $rows) > $page ) {
+            push @links, Data::HAL::Link->new(relation => 'next', href => sprintf('/%s?page=%d&rows=%d', $c->request->path, $page + 1, $rows));
+        }
+        if($page > 1) {
+            push @links, Data::HAL::Link->new(relation => 'prev', href => sprintf('/%s?page=%d&rows=%d', $c->request->path, $page - 1, $rows));
+        }
+
+        my $hal = Data::HAL->new(
+            embedded => [@embedded],
+            links => [@links],
+        );
+        $hal->resource({
+            total_count => $total_count,
+        });
+        my $response = HTTP::Response->new(HTTP_OK, undef, 
+            HTTP::Headers->new($hal->http_headers(skip_links => 1)), $hal->as_json);
+        $c->response->headers($response->headers);
+        $c->response->body($response->content);
+        return;
+    }
+    return;
+}
+
+sub HEAD :Allow {
+    my ($self, $c) = @_;
+    $c->forward(qw(GET));
+    $c->response->body(q());
+    return;
+}
+
+sub OPTIONS :Allow {
+    my ($self, $c) = @_;
+    my $allowed_methods = $self->allowed_methods;
+    $c->response->headers(HTTP::Headers->new(
+        Allow => $allowed_methods->join(', '),
+        Accept_Post => 'application/hal+json; profile=http://purl.org/sipwise/ngcp-api/#rel-'.$self->resource_name,
+    ));
+    $c->response->content_type('application/json');
+    $c->response->body(JSON::to_json({ methods => $allowed_methods })."\n");
+    return;
+}
+
+sub POST :Allow {
+    my ($self, $c) = @_;
+
+    my $guard = $c->model('DB')->txn_scope_guard;
+    {
+        my $recording = $self->get_valid_raw_post_data(
+            c => $c, 
+            media_type => 'audio/x-wav',
+        );
+        last unless $recording;
+        my $resource = $c->req->query_params;
+
+        my $form = $self->get_form($c);
+        last unless $self->validate_form(
+            c => $c,
+            resource => $resource,
+            form => $form,
+            exceptions => [ "set_id" ],
+        );
+        $resource->{loopplay} = ($resource->{loopplay} eq "true" || $resource->{loopplay}->is_int && $resource->{loopplay}) ? 1 : 0;
+
+
+        my $set_rs = $c->model('DB')->resultset('voip_sound_sets')->search({ 
+            id => $resource->{set_id} 
+        });
+        if($c->user->roles eq "admin") {
+        } elsif($c->user->roles eq "reseller") {
+            $set_rs = $set_rs->search({
+                reseller_id => $c->user->reseller_id,
+            });
+        }
+        my $set = $set_rs->first;
+        unless($set) {
+            $c->log->error("invalid set_id '$$resource{set_id}'");
+            $self->error($c, HTTP_UNPROCESSABLE_ENTITY, "Sound set does not exist");
+            last;
+        }
+
+        my $handle_rs = $c->model('DB')->resultset('voip_sound_handles')->search({
+            'me.name' => $resource->{handle},   
+        });
+        my $handle;
+        if($set->contract_id) {
+            $handle_rs = $handle_rs->search({
+                'group.name' => { 'in' => ['pbx'] }
+            },{
+                join => 'group'
+            });
+            $handle = $handle_rs->first;
+            unless($handle) {
+                $c->log->error("invalid handle '$$resource{handle}', must be in group pbx or music_on_hold for a customer sound set");
+                $self->error($c, HTTP_UNPROCESSABLE_ENTITY, "Handle must be in group pbx or music_on_hold for a customer sound set");
+                last;
+            }
+        } else {
+            $handle_rs = $handle_rs->search({
+                'group.name' => { 'not in' => ['pbx'] }
+            },{
+                join => 'group'
+            });
+            $handle = $handle_rs->first;
+            unless($handle) {
+                $c->log->error("invalid handle '$$resource{handle}', must not be in group pbx for a system sound set");
+                $self->error($c, HTTP_UNPROCESSABLE_ENTITY, "Handle must not be in group pbx for a system sound set");
+                last;
+            }
+        }
+        $resource->{handle_id} = $handle->id;
+
+        $resource->{data} = $recording;
+        if($resource->{handle} eq 'music_on_hold' && !$set->contract_id) {
+            $resource->{codec} = 'PCMA';
+            $resource->{filename} =~ s/\.[^.]+$/.pcma/;
+        } else {
+            $resource->{codec} = 'WAV';
+        }
+        $resource = $self->transcode_data($c, 'WAV', $resource);
+        last unless($resource);
+        delete $resource->{handle};
+
+        my $item;
+        try {
+            $item = $c->model('DB')->resultset('voip_sound_files')->create($resource);
+        } catch($e) {
+            $c->log->error("failed to create soundfile: $e"); # TODO: user, message, trace, ...
+            $self->error($c, HTTP_INTERNAL_SERVER_ERROR, "Failed to create soundfile.");
+            last;
+        }
+
+        $guard->commit;
+
+        $c->response->status(HTTP_CREATED);
+        $c->response->header(Location => sprintf('/%s%d', $c->request->path, $item->id));
+        $c->response->body(q());
+    }
+    return;
+}
+
+sub end : Private {
+    my ($self, $c) = @_;
+
+    $self->log_response($c);
+}
+
+# vim: set tabstop=4 expandtab:

lib/NGCP/Panel/Controller/API/SoundFilesItem.pm

@@ -0,0 +1,150 @@
+package NGCP::Panel::Controller::API::SoundFilesItem;
+use Sipwise::Base;
+use namespace::sweep;
+use HTTP::Headers qw();
+use HTTP::Status qw(:constants);
+use MooseX::ClassAttribute qw(class_has);
+use NGCP::Panel::Utils::DateTime;
+use NGCP::Panel::Utils::ValidateJSON qw();
+use Path::Tiny qw(path);
+use Safe::Isa qw($_isa);
+BEGIN { extends 'Catalyst::Controller::ActionRole'; }
+require Catalyst::ActionRole::ACL;
+require Catalyst::ActionRole::HTTPMethods;
+require Catalyst::ActionRole::RequireSSL;
+
+with 'NGCP::Panel::Role::API::SoundFiles';
+
+class_has('resource_name', is => 'ro', default => 'soundfiles');
+class_has('dispatch_path', is => 'ro', default => '/api/soundfiles/');
+class_has('relation', is => 'ro', default => 'http://purl.org/sipwise/ngcp-api/#rel-soundfiles');
+
+__PACKAGE__->config(
+    action => {
+        map { $_ => {
+            ACLDetachTo => '/api/root/invalid_user',
+            AllowedRole => [qw/admin reseller/],
+            Args => 1,
+            Does => [qw(ACL RequireSSL)],
+            Method => $_,
+            Path => __PACKAGE__->dispatch_path,
+        } } @{ __PACKAGE__->allowed_methods }
+    },
+    action_roles => [qw(HTTPMethods)],
+);
+
+sub auto :Private {
+    my ($self, $c) = @_;
+
+    $self->set_body($c);
+    $self->log_request($c);
+}
+
+sub GET :Allow {
+    my ($self, $c, $id) = @_;
+    {
+        last unless $self->valid_id($c, $id);
+        my $item = $self->item_by_id($c, $id);
+        last unless $self->resource_exists($c, soundfile => $item);
+
+        my $hal = $self->hal_from_item($c, $item);
+
+        my $response = HTTP::Response->new(HTTP_OK, undef, HTTP::Headers->new(
+            (map { # XXX Data::HAL must be able to generate links with multiple relations
+                s|rel="(http://purl.org/sipwise/ngcp-api/#rel-resellers)"|rel="item $1"|;
+                s/rel=self/rel="item self"/;
+                $_
+            } $hal->http_headers),
+        ), $hal->as_json);
+        $c->response->headers($response->headers);
+        $c->response->body($response->content);
+        return;
+    }
+    return;
+}
+
+sub HEAD :Allow {
+    my ($self, $c, $id) = @_;
+    $c->forward(qw(GET));
+    $c->response->body(q());
+    return;
+}
+
+sub OPTIONS :Allow {
+    my ($self, $c, $id) = @_;
+    my $allowed_methods = $self->allowed_methods;
+    $c->response->headers(HTTP::Headers->new(
+        Allow => $allowed_methods->join(', '),
+        Accept_Patch => 'application/json-patch+json',
+    ));
+    $c->response->content_type('application/json');
+    $c->response->body(JSON::to_json({ methods => $allowed_methods })."\n");
+    return;
+}
+
+sub PUT :Allow {
+    my ($self, $c, $id) = @_;
+    my $guard = $c->model('DB')->txn_scope_guard;
+    {
+        my $preference = $self->require_preference($c);
+        last unless $preference;
+
+        my $item = $self->item_by_id($c, $id);
+        last unless $self->resource_exists($c, soundfile => $item);
+        my $recording = $self->get_valid_raw_put_data(
+            c => $c,
+            id => $id,
+            media_type => 'audio/x-wav',
+        );
+        last unless $recording;
+        my $resource = $c->req->query_params;
+        $resource->{data} = $recording;
+        my $form = $self->get_form($c);
+        my $old_resource = $self->resource_from_item($c, $item, $form);
+
+        $item = $self->update_item($c, $item, $old_resource, $resource, $form);
+        last unless $item;
+
+        $guard->commit; 
+
+        if ('minimal' eq $preference) {
+            $c->response->status(HTTP_NO_CONTENT);
+            $c->response->header(Preference_Applied => 'return=minimal');
+            $c->response->body(q());
+        } else {
+            my $hal = $self->hal_from_item($c, $item, $form);
+            my $response = HTTP::Response->new(HTTP_OK, undef, HTTP::Headers->new(
+                $hal->http_headers,
+            ), $hal->as_json);
+            $c->response->headers($response->headers);
+            $c->response->header(Preference_Applied => 'return=representation');
+            $c->response->body($response->content);
+        }
+    }
+    return;
+}
+
+sub DELETE :Allow {
+    my ($self, $c, $id) = @_;
+
+    my $guard = $c->model('DB')->txn_scope_guard;
+    {
+        my $item = $self->item_by_id($c, $id);
+        last unless $self->resource_exists($c, soundfile => $item);
+        $item->delete;
+
+        $guard->commit;
+
+        $c->response->status(HTTP_NO_CONTENT);
+        $c->response->body(q());
+    }
+    return;
+}
+
+sub end : Private {
+    my ($self, $c) = @_;
+
+    $self->log_response($c);
+}
+
+# vim: set tabstop=4 expandtab:

lib/NGCP/Panel/Form/Sound/FileAPI.pm

@@ -0,0 +1,51 @@
+package NGCP::Panel::Form::Sound::FileAPI;
+
+use HTML::FormHandler::Moose;
+extends 'HTML::FormHandler';
+use Moose::Util::TypeConstraints;
+
+use HTML::FormHandler::Widget::Block::Bootstrap;
+
+has '+enctype' => ( default => 'multipart/form-data');
+has '+widget_wrapper' => ( default => 'Bootstrap' );
+has_field 'submitid' => ( type => 'Hidden' );
+
+has_field 'loopplay' => (
+    type => 'Boolean',
+    required => 1,
+    element_attr => {
+        rel => ['tooltip'],
+        title => ['Play file in a loop.'],
+    },
+);
+
+has_field 'filename' => (
+    type => 'Text',
+    required => 1,
+    element_attr => {
+        rel => ['tooltip'],
+        title => ['The filename of the sound file (for informational purposes only).'],
+    },
+);
+
+has_field 'set_id' => (
+    type => 'PosInteger',
+    required => 1,
+    element_attr => {
+        rel => ['tooltip'],
+        title => ['The sound set the sound file belongs to.'],
+    },
+);
+
+has_field 'handle' => (
+    type => 'Text',
+    required => 1,
+    element_attr => {
+        rel => ['tooltip'],
+        title => ['The sound handle when to play this sound file.'],
+    },
+);
+
+1;
+
+# vim: set tabstop=4 expandtab:

lib/NGCP/Panel/Role/API.pm

@@ -21,19 +21,36 @@ has('last_modified', is => 'rw', isa => InstanceOf['DateTime']);
 sub get_valid_post_data {
     my ($self, %params) = @_;
 
+    my $c = $params{c};
+    my $media_type = $params{media_type};
+    my $json =  $self->get_valid_raw_post_data(%params);
+    return unless $self->require_wellformed_json($c, $media_type, $json);
+    return JSON::from_json($json);
+}
+
+sub get_valid_raw_post_data {
+    my ($self, %params) = @_;
+
     my $c = $params{c};
     my $media_type = $params{media_type};
 
     return unless $self->forbid_link_header($c);
     return unless $self->valid_media_type($c, $media_type);
     return unless $self->require_body($c);
-    my $json =  $c->stash->{body};
-    return unless $self->require_wellformed_json($c, $media_type, $json);
+    return $c->stash->{body};
+}
 
+sub get_valid_put_data {
+    my ($self, %params) = @_;
+
+    my $c = $params{c};
+    my $media_type = $params{media_type};
+    my $json =  $self->get_valid_raw_put_data(%params);
+    return unless $self->require_wellformed_json($c, $media_type, $json);
     return JSON::from_json($json);
 }
 
-sub get_valid_put_data {
+sub get_valid_raw_put_data {
     my ($self, %params) = @_;
 
     my $c = $params{c};
@@ -44,10 +61,7 @@ sub get_valid_put_data {
     return unless $self->forbid_link_header($c);
     return unless $self->valid_media_type($c, $media_type);
     return unless $self->require_body($c);
-    my $json =  $c->stash->{body};
-    return unless $self->require_wellformed_json($c, $media_type, $json);
-
-    return JSON::from_json($json);
+    return $c->stash->{body};
 }
 
 sub get_valid_patch_data {

lib/NGCP/Panel/Role/API/SoundFiles.pm

@@ -0,0 +1,194 @@
+package NGCP::Panel::Role::API::SoundFiles;
+use Moose::Role;
+use Sipwise::Base;
+with 'NGCP::Panel::Role::API' => {
+    -alias       =>{ item_rs  => '_item_rs', },
+    -excludes    => [ 'item_rs' ],
+};
+
+use boolean qw(true);
+use TryCatch;
+use Data::HAL qw();
+use Data::HAL::Link qw();
+use HTTP::Status qw(:constants);
+use File::Temp qw(tempfile);
+use NGCP::Panel::Form::Sound::FileAPI;
+use NGCP::Panel::Utils::Sounds;
+
+sub transcode_data {
+    my ($self, $c, $from_codec, $resource) = @_;
+
+    my ($fh, $filename) = tempfile();
+    print $fh $resource->{data};
+    try {
+        $resource->{data} = NGCP::Panel::Utils::Sounds::transcode_file(
+            $filename, $from_codec, $resource->{codec},
+        );
+    } catch($e) {
+        $self->log->error("failed to transcode file: $e");
+        $self->error($c, HTTP_UNPROCESSABLE_ENTITY, "Failed to transcode file");
+        return;
+    }
+    return $resource;
+}
+
+sub item_rs {
+    my ($self, $c) = @_;
+
+    my $item_rs = $c->model('DB')->resultset('voip_sound_files')->search(
+        {}, 
+        {
+            prefetch => ['handle', 'set']
+        });
+    if($c->user->roles eq "admin") {
+    } elsif($c->user->roles eq "reseller") {
+        $item_rs = $item_rs->search({
+            'set.reseller_id' => $c->user->reseller_id
+        },{
+            join => 'set',
+        });
+    }
+    return $item_rs;
+}
+
+sub get_form {
+    my ($self, $c) = @_;
+    return NGCP::Panel::Form::Sound::FileAPI->new;
+}
+
+sub hal_from_item {
+    my ($self, $c, $item, $form) = @_;
+
+    $form //= $self->get_form($c);
+    my $resource = $self->resource_from_item($c, $item, $form);
+
+    my $hal = Data::HAL->new(
+        links => [
+            Data::HAL::Link->new(
+                relation => 'curies',
+                href => 'http://purl.org/sipwise/ngcp-api/#rel-{rel}',
+                name => 'ngcp',
+                templated => true,
+            ),
+            Data::HAL::Link->new(relation => 'collection', href => sprintf("/api/%s/", $self->resource_name)),
+            Data::HAL::Link->new(relation => 'profile', href => 'http://purl.org/sipwise/ngcp-api/'),
+            Data::HAL::Link->new(relation => 'self', href => sprintf("%s%d", $self->dispatch_path, $item->id)),
+            Data::HAL::Link->new(relation => 'ngcp:soundsets', href => sprintf("/api/soundsets/%d", $item->set_id)),
+            Data::HAL::Link->new(relation => 'ngcp:soundfilerecordings', href => sprintf("/api/soundfilerecordings/%d", $item->id)),
+        ],
+        relation => 'ngcp:'.$self->resource_name,
+    );
+
+
+    $self->validate_form(
+        c => $c,
+        resource => $resource,
+        form => $form,
+        run => 0,
+        exceptions => [ "set_id" ],
+    );
+
+    $resource->{id} = int($item->id);
+    $hal->resource($resource);
+    return $hal;
+}
+
+sub resource_from_item {
+    my ($self, $c, $item, $form) = @_;
+
+    my $resource = { $item->get_inflated_columns };
+    delete $resource->{data};
+    $resource->{filename} =~ s/\.pcma$/.wav/;
+
+    $resource->{handle} = $item->handle->name;
+    delete $resource->{handle_id};
+
+    return $resource;
+}
+
+sub item_by_id {
+    my ($self, $c, $id) = @_;
+    my $item_rs = $self->item_rs($c);
+    return $item_rs->find($id);
+}
+
+sub update_item {
+    my ($self, $c, $item, $old_resource, $resource, $form) = @_;
+
+    my $recording = delete $resource->{data};
+    $form //= $self->get_form($c);
+    return unless $self->validate_form(
+        c => $c,
+        form => $form,
+        resource => $resource,
+        exceptions => [ "set_id" ],
+    );
+
+    $resource->{loopplay} = ($resource->{loopplay} eq "true" || $resource->{loopplay}->is_int && $resource->{loopplay}) ? 1 : 0;
+
+
+    my $set_rs = $c->model('DB')->resultset('voip_sound_sets')->search({ 
+        id => $resource->{set_id} 
+    });
+    if($c->user->roles eq "admin") {
+    } elsif($c->user->roles eq "reseller") {
+        $set_rs = $set_rs->search({
+            reseller_id => $c->user->reseller_id,
+        });
+    }
+    my $set = $set_rs->first;
+    unless($set) {
+        $c->log->error("invalid set_id '$$resource{set_id}'");
+        $self->error($c, HTTP_UNPROCESSABLE_ENTITY, "Sound set does not exist");
+        last;
+    }
+
+    my $handle_rs = $c->model('DB')->resultset('voip_sound_handles')->search({
+        'me.name' => $resource->{handle},   
+    });
+    my $handle;
+    if($set->contract_id) {
+        $handle_rs = $handle_rs->search({
+            'group.name' => { 'in' => ['pbx'] }
+        },{
+            join => 'group'
+        });
+        $handle = $handle_rs->first;
+        unless($handle) {
+            $c->log->error("invalid handle '$$resource{handle}', must be in group pbx or music_on_hold for a customer sound set");
+            $self->error($c, HTTP_UNPROCESSABLE_ENTITY, "Handle must be in group pbx or music_on_hold for a customer sound set");
+            last;
+        }
+    } else {
+        $handle_rs = $handle_rs->search({
+            'group.name' => { 'not in' => ['pbx'] }
+        },{
+            join => 'group'
+        });
+        $handle = $handle_rs->first;
+        unless($handle) {
+            $c->log->error("invalid handle '$$resource{handle}', must not be in group pbx for a system sound set");
+            $self->error($c, HTTP_UNPROCESSABLE_ENTITY, "Handle must not be in group pbx for a system sound set");
+            last;
+        }
+    }
+    $resource->{handle_id} = $handle->id;
+
+    if($resource->{handle} eq 'music_on_hold' && !$set->contract_id) {
+        $resource->{codec} = 'PCMA';
+        $resource->{filename} =~ s/\.[^.]+$/.pcma/;
+    } else {
+        $resource->{codec} = 'WAV';
+    }
+    $resource->{data} = $recording;
+    $resource = $self->transcode_data($c, 'WAV', $resource);
+    last unless($resource);
+    delete $resource->{handle};
+
+    $item->update($resource);
+
+    return $item;
+}
+
+1;
+# vim: set tabstop=4 expandtab: