#pragma once

#ifdef __cplusplus
extern "C" {
#define this this_
#define new new_
#define delete delete_
#endif

#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>

typedef struct {
	const char* fileName;
	int32_t modified;
	const char* author;
	size_t size;
	size_t totalSize;
	bool executable;
	bool directory;
	bool official;
} CC4Group_EntryInfo;

typedef struct CC4Group_t CC4Group;

typedef void(*CC4Group_CleanupFunc)(void* data);
typedef struct {
	CC4Group_CleanupFunc func;
	void* data;
} CC4Group_CleanupJob;
typedef void* (*CC4Group_TmpMemoryStrategy)(CC4Group* const this, const size_t size, CC4Group_CleanupJob* cleanupJob);

typedef struct {
	CC4Group* (*new)(void);
	bool (*create)(CC4Group* const this);
	void (*delete)(CC4Group* const this);

	// only open an existing group on a frehsly created group object
	bool (*openExisting)(CC4Group* const this, const char* const path);

	bool (*save)(CC4Group* const this, const char* const path);
	bool (*saveOverwrite)(CC4Group* const this, const char* const path);

	// extraction to disk
	bool (*extractAll)(CC4Group* const this, const char* const targetPath);
	bool (*extractSingle)(CC4Group* const this, const char* const entryPath, const char* const targetPath);

	// the group owns the data pointed to. the pointer is valid until the group destructor is called
	bool (*getEntryData)(CC4Group* const this, const char* const entryPath, const void** const data, size_t* const size);

	// the returned error message pointer is valid until the next call to getErrorMessage is issued or the group is destructed
	const char* (*getErrorMessage)(CC4Group* const this);

	int32_t (*getErrorCode)(const CC4Group* const this);

	const char* (*getErrorMethod)(const CC4Group* const this);
	const char* (*getErrorCauser)(const CC4Group* const this);

	struct {
		CC4Group_TmpMemoryStrategy Memory;
		CC4Group_TmpMemoryStrategy File;
		CC4Group_TmpMemoryStrategy Auto;
	} const TmpMemoryStrategies;

	struct {
		int Take; // cc4group will free the data when its not needed anymore; e.g. in the destructor or when setting the file's data again
		int Copy; // cc4group will copy the data to use it; the original data is untouched and needs to be freed by the caller whenever desired
		int Reference; // cc4group will use the data as is (i.e. store the pointer and use it); the caller must guarantee it's validity throughout the groups lifetime (or until the file's data is set to a new pointer) and needs to take care of freeing it afterwards
	} const MemoryManagement;

	void (*setTmpMemoryStrategy)(const CC4Group_TmpMemoryStrategy strategy);

	// group metadata handling
	bool (*setMaker)(CC4Group* const this, const char* const maker, const char* const path, bool const recursive);
	bool (*setCreation)(CC4Group* const this, int32_t const creation, const char* const path, bool const recursive);
	bool (*setOfficial)(CC4Group* const this, bool const official, const char* const path, bool const recursive);
	bool (*setExecutable)(CC4Group* const this, bool const executable, const char* const path);

	bool (*getEntryInfo)(CC4Group* const this, const char* const path, CC4Group_EntryInfo* const info);
	bool (*getEntryInfos)(CC4Group* const this, const char* const path, CC4Group_EntryInfo** const infos, size_t* const size);

	// modifying the group
	bool (*deleteEntry)(CC4Group* const this, const char* const path, bool const recursive);
	bool (*renameEntry)(CC4Group* const this, const char* const oldPath, const char* const newPath);
	bool (*createDirectory)(CC4Group* const this, const char* const path);

	bool (*createFile)(CC4Group* const this, const char* const path);

	// see the description of MemoryManagement to know if and when data has to be freed by the caller
	bool (*setEntryData)(CC4Group* const this, const char* const entryPath, const void* const data, size_t const size, int const memoryManagementMode);
} const CC4Group_API;

#ifndef CC4GROUP_DYNAMIC_LOAD
extern CC4Group_API cc4group;
#endif

#ifdef __cplusplus
}
#undef this
#undef new
#undef delete
#endif