Compare commits
1 Commits
main
..
4ec476b9a5
| Author | SHA1 | Date | |
|---|---|---|---|
| 4ec476b9a5 |
@@ -23,8 +23,8 @@ use KTXF\Resource\Identifier\EntityIdentifier;
|
|||||||
use KTXF\Resource\Identifier\ResourceIdentifier;
|
use KTXF\Resource\Identifier\ResourceIdentifier;
|
||||||
use KTXF\Resource\Identifier\ResourceIdentifiers;
|
use KTXF\Resource\Identifier\ResourceIdentifiers;
|
||||||
use KTXF\Resource\Identifier\ServiceIdentifier;
|
use KTXF\Resource\Identifier\ServiceIdentifier;
|
||||||
|
use KTXF\Mail\Provider\ProviderBaseInterface;
|
||||||
use KTXF\Resource\Provider\ResourceServiceLocationInterface;
|
use KTXF\Resource\Provider\ResourceServiceLocationInterface;
|
||||||
use KTXF\Resource\SystemIdentity;
|
|
||||||
use KTXF\Routing\Attributes\AuthenticatedRoute;
|
use KTXF\Routing\Attributes\AuthenticatedRoute;
|
||||||
use KTXM\MailManager\Manager;
|
use KTXM\MailManager\Manager;
|
||||||
use Psr\Log\LoggerInterface;
|
use Psr\Log\LoggerInterface;
|
||||||
@@ -86,7 +86,7 @@ class DefaultController extends ControllerAbstract {
|
|||||||
// acting-user override: only the reserved system context is permitted,
|
// acting-user override: only the reserved system context is permitted,
|
||||||
// gated on the system mail management permission
|
// gated on the system mail management permission
|
||||||
if ($user !== null && $user !== $userId) {
|
if ($user !== null && $user !== $userId) {
|
||||||
if ($user !== SystemIdentity::USER || !$this->identityContext->hasPermission('mail_manager.system')) {
|
if ($user !== ProviderBaseInterface::USER_SYSTEM || !$this->identityContext->hasPermission('mail_manager.system')) {
|
||||||
return new JsonResponse([
|
return new JsonResponse([
|
||||||
'version' => $version,
|
'version' => $version,
|
||||||
'transaction' => $transaction,
|
'transaction' => $transaction,
|
||||||
@@ -180,7 +180,6 @@ class DefaultController extends ControllerAbstract {
|
|||||||
'entity.copy' => throw new InvalidArgumentException('Operation not implemented: ' . $operation),
|
'entity.copy' => throw new InvalidArgumentException('Operation not implemented: ' . $operation),
|
||||||
'entity.submit' => $this->entitySubmit($tenantId, $userId, $data),
|
'entity.submit' => $this->entitySubmit($tenantId, $userId, $data),
|
||||||
'entity.download' => $this->entityDownload($tenantId, $userId, $data),
|
'entity.download' => $this->entityDownload($tenantId, $userId, $data),
|
||||||
'entity.preview' => $this->entityPreview($tenantId, $userId, $data),
|
|
||||||
'entity.blobs' => $this->entityBlobs($tenantId, $userId, $data),
|
'entity.blobs' => $this->entityBlobs($tenantId, $userId, $data),
|
||||||
|
|
||||||
default => throw new InvalidArgumentException(self::ERR_INVALID_OPERATION . $operation)
|
default => throw new InvalidArgumentException(self::ERR_INVALID_OPERATION . $operation)
|
||||||
@@ -969,36 +968,4 @@ class DefaultController extends ControllerAbstract {
|
|||||||
return $results;
|
return $results;
|
||||||
}
|
}
|
||||||
|
|
||||||
private function entityPreview(string $tenantId, string $userId, array $data): Response {
|
|
||||||
if (!isset($data['target']) || !is_string($data['target'])) {
|
|
||||||
throw new InvalidArgumentException(self::ERR_MISSING_TARGET);
|
|
||||||
}
|
|
||||||
if (!isset($data['part']) || !is_array($data['part'])) {
|
|
||||||
throw new InvalidArgumentException('Attachment preview requires a part');
|
|
||||||
}
|
|
||||||
|
|
||||||
$target = ResourceIdentifier::fromString($data['target']);
|
|
||||||
if (!$target instanceof EntityIdentifier) {
|
|
||||||
throw new InvalidArgumentException(self::ERR_INVALID_IDENTIFIER);
|
|
||||||
}
|
|
||||||
$preview = $this->manager->entityPreview(
|
|
||||||
$tenantId,
|
|
||||||
$userId,
|
|
||||||
$target,
|
|
||||||
$data['part'],
|
|
||||||
isset($data['variant']) && is_string($data['variant']) ? $data['variant'] : 'inline',
|
|
||||||
);
|
|
||||||
if ($preview === null) {
|
|
||||||
return new Response('', Response::HTTP_NO_CONTENT);
|
|
||||||
}
|
|
||||||
|
|
||||||
return new StreamedResponse($preview->resource->stream(), Response::HTTP_OK, [
|
|
||||||
'Content-Type' => $preview->resource->mimeType(),
|
|
||||||
'Content-Length' => (string) $preview->size,
|
|
||||||
'ETag' => '"' . trim($preview->etag, '"') . '"',
|
|
||||||
'Cache-Control' => 'private, max-age=3600',
|
|
||||||
'X-Content-Type-Options' => 'nosniff',
|
|
||||||
]);
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|||||||
+7
-50
@@ -5,10 +5,7 @@ declare(strict_types=1);
|
|||||||
namespace KTXM\MailManager;
|
namespace KTXM\MailManager;
|
||||||
|
|
||||||
use InvalidArgumentException;
|
use InvalidArgumentException;
|
||||||
use KTXC\Preview\Preview;
|
|
||||||
use KTXC\Preview\PreviewManager;
|
|
||||||
use KTXC\Resource\ProviderManager;
|
use KTXC\Resource\ProviderManager;
|
||||||
use KTXF\Preview\PreviewSource;
|
|
||||||
use KTXF\Mail\Collection\CollectionBaseInterface;
|
use KTXF\Mail\Collection\CollectionBaseInterface;
|
||||||
use KTXF\Mail\Collection\CollectionPropertiesMutableInterface;
|
use KTXF\Mail\Collection\CollectionPropertiesMutableInterface;
|
||||||
use KTXF\Mail\Collection\ICollectionBase;
|
use KTXF\Mail\Collection\ICollectionBase;
|
||||||
@@ -50,7 +47,6 @@ class Manager {
|
|||||||
public function __construct(
|
public function __construct(
|
||||||
private LoggerInterface $logger,
|
private LoggerInterface $logger,
|
||||||
private ProviderManager $providerManager,
|
private ProviderManager $providerManager,
|
||||||
private PreviewManager $previewManager,
|
|
||||||
) { }
|
) { }
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -938,6 +934,13 @@ class Manager {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public function entityDownload(string $tenantId, string $userId, EntityIdentifier $targetEntity, array|null $targetPart): BinaryResource {
|
||||||
|
// retrieve service
|
||||||
|
$service = $this->serviceFetch($tenantId, $userId, $targetEntity->provider(), $targetEntity->service());
|
||||||
|
// download entity
|
||||||
|
return $service->entityDownload($targetEntity, $targetPart);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Check if messages exist
|
* Check if messages exist
|
||||||
*
|
*
|
||||||
@@ -1349,50 +1352,4 @@ class Manager {
|
|||||||
return $service->entitySubmit($sender, $source, $message);
|
return $service->entitySubmit($sender, $source, $message);
|
||||||
}
|
}
|
||||||
|
|
||||||
public function entityDownload(string $tenantId, string $userId, EntityIdentifier $targetEntity, array|null $targetPart): BinaryResource {
|
|
||||||
// retrieve service
|
|
||||||
$service = $this->serviceFetch($tenantId, $userId, $targetEntity->provider(), $targetEntity->service());
|
|
||||||
// download entity
|
|
||||||
return $service->entityDownload($targetEntity, $targetPart);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Resolve an authorized attachment and lazily generate or retrieve its preview.
|
|
||||||
*/
|
|
||||||
public function entityPreview(string $tenantId, string $userId, EntityIdentifier $targetEntity, array $part, string $variant = 'inline'): ?Preview {
|
|
||||||
$mimeType = $part['type'] ?? null;
|
|
||||||
$size = $part['size'] ?? null;
|
|
||||||
if (!is_string($mimeType) || ($size !== null && !is_int($size))) {
|
|
||||||
throw new InvalidArgumentException('Attachment preview requires a MIME type and optional integer size');
|
|
||||||
}
|
|
||||||
|
|
||||||
$selector = array_filter([
|
|
||||||
'blobId' => $part['blobId'] ?? null,
|
|
||||||
'partId' => $part['partId'] ?? null,
|
|
||||||
'cid' => $part['cid'] ?? null,
|
|
||||||
], static fn(mixed $value): bool => is_string($value) && $value !== '');
|
|
||||||
if ($selector === []) {
|
|
||||||
throw new InvalidArgumentException('Attachment preview requires a blob, part, or content identifier');
|
|
||||||
}
|
|
||||||
|
|
||||||
$attachmentIdentity = hash('sha256', json_encode($selector, JSON_THROW_ON_ERROR));
|
|
||||||
|
|
||||||
return $this->previewManager->fetch($tenantId, new PreviewSource(
|
|
||||||
sourceType: 'mail-attachment',
|
|
||||||
identity: (string) $targetEntity . ':' . $attachmentIdentity,
|
|
||||||
// Attachments are immutable once delivered, so there is no revision to track;
|
|
||||||
// existence and access are enforced by entityDownload() (via serviceFetch) below,
|
|
||||||
// which only runs on a cache miss.
|
|
||||||
signature: 'immutable',
|
|
||||||
mimeType: $mimeType,
|
|
||||||
size: $size,
|
|
||||||
resourceFactory: fn(): BinaryResource => $this->entityDownload(
|
|
||||||
$tenantId,
|
|
||||||
$userId,
|
|
||||||
$targetEntity,
|
|
||||||
$selector,
|
|
||||||
),
|
|
||||||
), $variant);
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|||||||
+12
-8
@@ -2,8 +2,7 @@
|
|||||||
|
|
||||||
namespace KTXM\MailManager;
|
namespace KTXM\MailManager;
|
||||||
|
|
||||||
use KTXF\Module\Configuration\BrowserModuleContextInterface;
|
use KTXF\Module\ModuleBrowserInterface;
|
||||||
use KTXF\Module\Configuration\ModuleContextInterface;
|
|
||||||
use KTXF\Module\ModuleInstanceAbstract;
|
use KTXF\Module\ModuleInstanceAbstract;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -12,7 +11,7 @@ use KTXF\Module\ModuleInstanceAbstract;
|
|||||||
* Provides unified mail sending and management across multiple providers
|
* Provides unified mail sending and management across multiple providers
|
||||||
* with context-aware service discovery and queued delivery.
|
* with context-aware service discovery and queued delivery.
|
||||||
*/
|
*/
|
||||||
class Module extends ModuleInstanceAbstract
|
class Module extends ModuleInstanceAbstract implements ModuleBrowserInterface
|
||||||
{
|
{
|
||||||
|
|
||||||
public function __construct()
|
public function __construct()
|
||||||
@@ -59,10 +58,15 @@ class Module extends ModuleInstanceAbstract
|
|||||||
];
|
];
|
||||||
}
|
}
|
||||||
|
|
||||||
public function configure(ModuleContextInterface $context): void
|
public function registerBI(): array {
|
||||||
{
|
return [
|
||||||
if ($context instanceof BrowserModuleContextInterface) {
|
'handle' => $this->handle(),
|
||||||
$context->registerModule($this, 'MailManager', 'static/module.mjs');
|
'namespace' => 'MailManager',
|
||||||
}
|
'version' => $this->version(),
|
||||||
|
'label' => $this->label(),
|
||||||
|
'author' => $this->author(),
|
||||||
|
'description' => $this->description(),
|
||||||
|
'boot' => 'static/module.mjs',
|
||||||
|
];
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Generated
+7
-3
@@ -1041,7 +1041,9 @@
|
|||||||
"license": "MIT"
|
"license": "MIT"
|
||||||
},
|
},
|
||||||
"node_modules/@vue/language-core": {
|
"node_modules/@vue/language-core": {
|
||||||
"version": "3.3.7",
|
"version": "3.3.11",
|
||||||
|
"resolved": "https://registry.npmjs.org/@vue/language-core/-/language-core-3.3.11.tgz",
|
||||||
|
"integrity": "sha512-QJmpliwAVpC/OxubIByPAhNzsQPRc8/gxlN2qnVzVfIMjMDz/9RnXRFoetjz5yEgXVXyp4LqhXq3V53PjmNzFw==",
|
||||||
"dev": true,
|
"dev": true,
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
@@ -2990,12 +2992,14 @@
|
|||||||
}
|
}
|
||||||
},
|
},
|
||||||
"node_modules/vue-tsc": {
|
"node_modules/vue-tsc": {
|
||||||
"version": "3.3.7",
|
"version": "3.3.11",
|
||||||
|
"resolved": "https://registry.npmjs.org/vue-tsc/-/vue-tsc-3.3.11.tgz",
|
||||||
|
"integrity": "sha512-gOb0B9rtU2+f1dszwPqSH5kAieIF9ReeLhD3kSRNHv5WZZUQz/JdVXW0RTdqhNTMlQkqKzrTTviqKr/4FYZraQ==",
|
||||||
"dev": true,
|
"dev": true,
|
||||||
"license": "MIT",
|
"license": "MIT",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@volar/typescript": "2.4.28",
|
"@volar/typescript": "2.4.28",
|
||||||
"@vue/language-core": "3.3.7"
|
"@vue/language-core": "3.3.11"
|
||||||
},
|
},
|
||||||
"bin": {
|
"bin": {
|
||||||
"vue-tsc": "bin/vue-tsc.js"
|
"vue-tsc": "bin/vue-tsc.js"
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
* Entity management service
|
* Entity management service
|
||||||
*/
|
*/
|
||||||
|
|
||||||
import { transceivePost, transceiveStream, transceiveDownload, transceiveBlob } from './transceive';
|
import { transceivePost, transceiveStream, transceiveDownload } from './transceive';
|
||||||
import type {
|
import type {
|
||||||
EntityFetchRequest,
|
EntityFetchRequest,
|
||||||
EntityFetchResponse,
|
EntityFetchResponse,
|
||||||
@@ -28,7 +28,6 @@ import type {
|
|||||||
EntityPatchResponse,
|
EntityPatchResponse,
|
||||||
EntityPatchRequest,
|
EntityPatchRequest,
|
||||||
EntityDownloadRequest,
|
EntityDownloadRequest,
|
||||||
EntityPreviewRequest,
|
|
||||||
EntityBlobsRequest,
|
EntityBlobsRequest,
|
||||||
EntityBlobsResponse,
|
EntityBlobsResponse,
|
||||||
EntityBlobsWireResponse,
|
EntityBlobsWireResponse,
|
||||||
@@ -232,10 +231,6 @@ export const entityService = {
|
|||||||
return transceiveDownload<EntityDownloadRequest>('entity.download', request);
|
return transceiveDownload<EntityDownloadRequest>('entity.download', request);
|
||||||
},
|
},
|
||||||
|
|
||||||
async preview(request: EntityPreviewRequest): Promise<Blob> {
|
|
||||||
return await transceiveBlob<EntityPreviewRequest>('entity.preview', request);
|
|
||||||
},
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Fetch one or more message parts (attachments) inline for rendering.
|
* Fetch one or more message parts (attachments) inline for rendering.
|
||||||
*
|
*
|
||||||
|
|||||||
@@ -8,8 +8,9 @@ export { serviceService } from './serviceService';
|
|||||||
export { collectionService } from './collectionService';
|
export { collectionService } from './collectionService';
|
||||||
export { entityService } from './entityService';
|
export { entityService } from './entityService';
|
||||||
|
|
||||||
export * from '../types/common';
|
// Type exports
|
||||||
export * from '../types/provider';
|
export type * from '../types/common';
|
||||||
export * from '../types/service';
|
export type * from '../types/provider';
|
||||||
export * from '../types/collection';
|
export type * from '../types/service';
|
||||||
export * from '../types/entity';
|
export type * from '../types/collection';
|
||||||
|
export type * from '../types/entity';
|
||||||
|
|||||||
@@ -188,28 +188,6 @@ export function transceiveDownload<TRequest>(
|
|||||||
return { transaction: request.transaction };
|
return { transaction: request.transaction };
|
||||||
}
|
}
|
||||||
|
|
||||||
export async function transceiveBlob<TRequest>(operation: string, data: TRequest): Promise<Blob> {
|
|
||||||
const request: ApiRequest<TRequest> = {
|
|
||||||
version: API_VERSION,
|
|
||||||
transaction: generateTransactionId(),
|
|
||||||
operation,
|
|
||||||
data,
|
|
||||||
};
|
|
||||||
let blob: Blob | null = null;
|
|
||||||
await fetchWrapper.post(API_URL, request, {
|
|
||||||
headers: { 'Accept': '*/*' },
|
|
||||||
onStream: async (response: Response) => {
|
|
||||||
if (response.status === 204) {
|
|
||||||
throw new Error(`[${operation}] Preview unavailable`);
|
|
||||||
}
|
|
||||||
blob = await response.blob();
|
|
||||||
},
|
|
||||||
});
|
|
||||||
if (blob === null) throw new Error(`[${operation}] Empty preview response`);
|
|
||||||
return blob;
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
function appendHiddenField(form: HTMLFormElement, name: string, value: string): void {
|
function appendHiddenField(form: HTMLFormElement, name: string, value: string): void {
|
||||||
const input = document.createElement('input');
|
const input = document.createElement('input');
|
||||||
input.type = 'hidden';
|
input.type = 'hidden';
|
||||||
|
|||||||
@@ -10,7 +10,6 @@ import type {
|
|||||||
EntityBlobSelector,
|
EntityBlobSelector,
|
||||||
EntityBlobsResponse,
|
EntityBlobsResponse,
|
||||||
EntityDownloadRequest,
|
EntityDownloadRequest,
|
||||||
EntityPreviewRequest,
|
|
||||||
EntityTransmitRequest,
|
EntityTransmitRequest,
|
||||||
EntityTransmitResponse,
|
EntityTransmitResponse,
|
||||||
} from '../types/entity'
|
} from '../types/entity'
|
||||||
@@ -519,10 +518,6 @@ export const useEntitiesStore = defineStore('mailEntitiesStore', () => {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
async function preview(request: EntityPreviewRequest): Promise<Blob> {
|
|
||||||
return await entityService.preview(request)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Return public API
|
// Return public API
|
||||||
return {
|
return {
|
||||||
// State (readonly)
|
// State (readonly)
|
||||||
@@ -545,7 +540,6 @@ export const useEntitiesStore = defineStore('mailEntitiesStore', () => {
|
|||||||
move,
|
move,
|
||||||
transmit,
|
transmit,
|
||||||
download,
|
download,
|
||||||
preview,
|
|
||||||
blobs,
|
blobs,
|
||||||
}
|
}
|
||||||
})
|
})
|
||||||
|
|||||||
+1
-7
@@ -227,12 +227,6 @@ export interface EntityDownloadRequest {
|
|||||||
filename?: string | null;
|
filename?: string | null;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface EntityPreviewRequest {
|
|
||||||
target: EntityIdentifier;
|
|
||||||
part: EntityBlobSelector & { type: string; size?: number | null };
|
|
||||||
variant?: string;
|
|
||||||
}
|
|
||||||
|
|
||||||
export interface EntityBlobsRequest {
|
export interface EntityBlobsRequest {
|
||||||
target: EntityIdentifier;
|
target: EntityIdentifier;
|
||||||
parts: EntityBlobSelector[];
|
parts: EntityBlobSelector[];
|
||||||
@@ -252,4 +246,4 @@ export interface EntityBlobsResult extends Omit<EntityBlobsWireResult, 'bytes'>
|
|||||||
blob: Blob;
|
blob: Blob;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface EntityBlobsResponse extends Array<EntityBlobsResult> {}
|
export interface EntityBlobsResponse extends Array<EntityBlobsResult> {}
|
||||||
Reference in New Issue
Block a user