1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
//! Library for reading and writing the Adobe Flash Local Shared Object (LSO) file format and the contained AMF0/AMF3 data

#![warn(
    anonymous_parameters,
    nonstandard_style,
    rust_2018_idioms,
    trivial_casts,
    trivial_numeric_casts,
    unreachable_pub,
    unused_extern_crates,
    unused_qualifications,
    variant_size_differences,
    missing_docs
)]

use crate::amf3::AMF3Decoder;
use crate::types::{AMFVersion, Header, LSO};
use nom::branch::alt;
use nom::bytes::complete::tag;
use nom::number::complete::be_u32;
use nom::IResult;
use std::convert::TryInto;

const HEADER_VERSION: [u8; 2] = [0x00, 0xbf];
const HEADER_SIGNATURE: [u8; 10] = [0x54, 0x43, 0x53, 0x4f, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00];
const PADDING: [u8; 1] = [0x00];

const FORMAT_VERSION_AMF0: u8 = 0x0;
const FORMAT_VERSION_AMF3: u8 = 0x3;

#[cfg(feature = "serde")]
#[macro_use]
extern crate serde;

/// Reading and Writing of the AMF0 file format
pub mod amf0;
/// Reading and Writing of the AMF3 file format
pub mod amf3;

//TODO: custom error types
// mod errors;

#[cfg(feature = "flex")]
/// Reading and Writing of flex types
pub mod flex;
/// Types used for representing file contents
pub mod types;

mod element_cache;
mod length;
mod nom_utils;

/// The main entry point of decoding a SOL file
/// Example of use
/// ```
/// use std::fs::File;
/// use std::io::Read;
/// use flash_lso::LSODeserializer;
/// let mut x = File::open("tests/sol/AS2-Demo.sol").expect("Couldn't open file");
/// let mut data = Vec::new();
/// let _ = x.read_to_end(&mut data).expect("Unable to read file");
/// let d = LSODeserializer::default().parse(&data).expect("Failed to parse lso file");
/// println!("{:#?}", d);
/// ```
/// }
#[derive(Default)]
pub struct LSODeserializer {
    /// Handles reading Value::AMF3() wrapped types
    pub amf3_decoder: AMF3Decoder,
}

impl LSODeserializer {
    fn parse_header<'a>(&self, i: &'a [u8]) -> IResult<&'a [u8], Header> {
        let (i, _) = tag(HEADER_VERSION)(i)?;
        let (i, l) = be_u32(i)?;
        let (i, _) = tag(HEADER_SIGNATURE)(i)?;

        let (i, name) = amf0::decoder::parse_string(i)?;

        let (i, _) = tag(PADDING)(i)?;
        let (i, _) = tag(PADDING)(i)?;
        let (i, _) = tag(PADDING)(i)?;

        let (i, version) = alt((tag(&[FORMAT_VERSION_AMF0]), tag(&[FORMAT_VERSION_AMF3])))(i)?;

        // This unwrap can't fail because of the alt above
        let format_version: AMFVersion = version[0].try_into().unwrap();

        Ok((
            i,
            Header {
                length: l,
                name: name.to_string(),
                format_version,
            },
        ))
    }

    /// Read a given buffer as an LSO
    pub fn parse<'a>(&mut self, i: &'a [u8]) -> IResult<&'a [u8], LSO> {
        let (i, header) = self.parse_header(i)?;
        match header.format_version {
            AMFVersion::AMF0 => {
                let (i, body) = amf0::decoder::parse_body(i)?;
                Ok((i, LSO { header, body }))
            }
            AMFVersion::AMF3 => {
                let (i, body) = self.amf3_decoder.parse_body(i)?;
                Ok((i, LSO { header, body }))
            }
        }
    }
}

/// Handles encoding of LSO files
pub mod encoder {
    use crate::types::{AMFVersion, Header, LSO};
    use crate::{
        FORMAT_VERSION_AMF0, FORMAT_VERSION_AMF3, HEADER_SIGNATURE, HEADER_VERSION, PADDING,
    };
    use cookie_factory::bytes::be_u32;
    use cookie_factory::SerializeFn;
    use std::io::Write;

    use crate::amf0::encoder as amf0_encoder;
    use crate::amf3::encoder::AMF3Encoder;
    use crate::nom_utils::write_string;
    use cookie_factory::combinator::cond;
    use cookie_factory::combinator::slice;
    use cookie_factory::gen;
    use cookie_factory::sequence::tuple;

    /// Handles writing a given LSO
    #[derive(Default)]
    pub struct LSOSerializer {
        /// The encoder used for writing Value::AMF3() wrapped types
        pub amf3_encoder: AMF3Encoder,
    }

    impl LSOSerializer {
        /// Write a given LSO
        pub fn write_full<'a, 'b: 'a, W: Write + 'a>(
            &'a mut self,
            lso: &'b LSO,
        ) -> impl SerializeFn<W> + 'a {
            let amf0 = cond(
                lso.header.format_version == AMFVersion::AMF0,
                amf0_encoder::write_body(&lso.body),
            );
            let amf3 = cond(
                lso.header.format_version == AMFVersion::AMF3,
                self.amf3_encoder.write_body(&lso.body),
            );

            tuple((write_header(&lso.header), amf0, amf3))
        }
    }

    fn write_header<'a, 'b: 'a, W: Write + 'a>(header: &'b Header) -> impl SerializeFn<W> + 'a {
        tuple((
            slice(HEADER_VERSION),
            be_u32(header.length),
            slice(HEADER_SIGNATURE),
            write_string(&header.name),
            slice(PADDING),
            slice(PADDING),
            slice(PADDING),
            cond(
                header.format_version == AMFVersion::AMF0,
                slice(&[FORMAT_VERSION_AMF0]),
            ),
            cond(
                header.format_version == AMFVersion::AMF3,
                slice(&[FORMAT_VERSION_AMF3]),
            ),
        ))
    }

    /// Write a LSO to a vec of bytes
    pub fn write_to_bytes(lso: &LSO) -> Vec<u8> {
        let v = vec![];

        let mut s = LSOSerializer::default();
        let serialise = s.write_full(lso);
        let (buffer, _size) = gen(serialise, v).unwrap();
        buffer
    }
}