DataPackageManager: Deprecate service methods createDataPackageArhcive and readDataPackageArchive

[servilla]

Deprecate service methods DataPackageManageResource.createDataPackageArhcive and DataPackageManagerResource.readDataPackageArchive. Neither service method is required any longer since the addition of the DataPackageManagerResource.downloadDataPackageArchive, which is more efficient and does not require a system artifact to be generated.

Deprecation should be stepwise:
1 - Add deprecation message to API docs.
2 - Log calls to see if these methods are actively used.
3 - If yes, then provide automated messaging alerting users.
3 - If no, then remove them from the public facing API.

[servilla]

In regard to no. 3 "yes" above, the simplest solution is to remove all relevant executable code and rewrite the ServiceUnavailableException in both the createDataPackageArchive and readDataPackageArchive service methods to respond with a new deprecation message. for example:

try {
    String msg = "The createDataPackageArchive service method is no longer available. Use the downloadDataPackageArchive method instead.";
    throw new ServiceUnavailableException(msg);
}
catch (ServiceUnavailableException e) {
    response = WebExceptionFactory.makeServiceUnavailable(e).getResponse();
}

return response;

Below is an example of the an attempted request to the createDataPackageArchive service method:

http POST "http://localhost:8088/package/archive/eml/icarus/1/2"
HTTP/1.1 503 Service Unavailable
access-control-allow-origin: *
connection: close
content-type: text/plain
date: Tue, 03 Feb 2026 23:45:27 GMT
date: Tue, 03 Feb 2026 23:45:28 GMT
server: uvicorn
set-cookie: auth-token="cHVibGljKmh0dHBzOi8vcGFzdGEuZWRpcmVwb3NpdG9yeS5vcmcvYXV0aGVudGljYXRpb24qMTc3MDE5MTEyODExNw==-SFHuxmCXhBBKCNRM7citVkYkzS5umlbxVtb/MomrP1BXoUW9qpgOA3E8qhYdl6eqD/ow4Se29GEU2RYj18NfgKhootbv4t3xjZD0dtQYt1S/qOrbSlahQRlKDA1eA7MmVoesbrSmIEQusKQ/QIhjfbYwrAueIDdvSfYZTreo8Cn2OBDp4EQDePhEobKP7qDc8PTwXAN1YUFc/Kz2hvWC+9SB7Pk9tzICmhW+BXRolkl/8DW17ESDTZV3WSzmCxRTESxpDPurmzBsrUh7ZhgazDAmrRo/vPMjO2pGegfBuN0B6KBcmkKe+/4vqL1U/6hKWQZYiz7ohlKTx8OVnXEKtw=="; HttpOnly; Max-Age=0; Path=/; SameSite=lax
set-cookie: edi-token=eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJFREktMDc4ZTZlM2NlZTRmN2YyODEyZjE1MDcwMWRhOTM1MWFjYjUxZTA4OSIsImNuIjoiUHVibGljIEFjY2VzcyIsImVtYWlsIjpudWxsLCJwcmluY2lwYWxzIjpbXSwibGlua3MiOltdLCJpc0VtYWlsRW5hYmxlZCI6ZmFsc2UsImlzRW1haWxWZXJpZmllZCI6ZmFsc2UsImlkcENvbW1vbk5hbWUiOiJQdWJsaWMgQWNjZXNzIiwiaWRwTmFtZSI6InN5c3RlbSIsImlkcFVpZCI6bnVsbCwiaXNzIjoiaHR0cHM6Ly9hdXRoLmVkaXJlcG9zaXRvcnkub3JnIiwiaGQiOiJlZGlyZXBvc2l0b3J5Lm9yZyIsImlhdCI6MTc3MDE2MjMyOCwibmJmIjoxNzcwMTYyMzI4LCJleHAiOjE3NzAxOTExMjh9.VCtqVmwuh60YM0x2OKRu-B4qP7CIlQCtc6OXKNQJkHjGTVDkwAd3JH7kEe9IGPvARKnw3nFiJotLSogJttBKmA; HttpOnly; Max-Age=0; Path=/; SameSite=lax
transfer-encoding: chunked

The createDataPackageArchive service method is no longer available. Use the downloadDataPackageArchive method instead. (2026-02-03 23:45:28.271)