@keetanetwork/anchor 0.0.39 → 0.0.41

package/services/storage/common.d.ts

@@ -0,0 +1,667 @@
+import type { lib as KeetaNetLib } from '@keetanetwork/keetanet-client';
+import type { HTTPSignedField } from '../../lib/http-server/common.js';
+import type { Signable } from '../../lib/utils/signing.js';
+import { KeetaAnchorUserError, KeetaAnchorUserValidationError } from '../../lib/error.js';
+import { Buffer } from '../../lib/utils/buffer.js';
+/**
+ * Type alias for a KeetaNet Account instance.
+ * Used throughout the storage service for account authentication and signing.
+ */
+export type KeetaNetAccount = InstanceType<typeof KeetaNetLib.Account>;
+/** Content type for JSON payloads */
+export declare const CONTENT_TYPE_JSON = "application/json";
+/** Content type for binary/octet-stream payloads */
+export declare const CONTENT_TYPE_OCTET_STREAM = "application/octet-stream";
+/** Default TTL for signed URLs in seconds (1 hour) */
+export declare const DEFAULT_SIGNED_URL_TTL_SECONDS = 3600;
+/**
+ * Visibility of a storage object
+ */
+export type StorageObjectVisibility = 'public' | 'private';
+/**
+ * Metadata for a stored object
+ */
+export type StorageObjectMetadata = {
+    /**
+     * Full path (the unique ID)
+     */
+    path: string;
+    /**
+     * Owner's identifier
+     */
+    owner: string;
+    /**
+     * Plaintext tags (searchable)
+     */
+    tags: string[];
+    /**
+     * Visibility setting
+     */
+    visibility: StorageObjectVisibility;
+    /**
+     * Size in bytes
+     */
+    size: number;
+    /**
+     * ISO timestamp of creation
+     */
+    createdAt: string;
+    /**
+     * ISO timestamp of last update
+     */
+    updatedAt?: string;
+};
+/**
+ * Criteria for searching storage objects.
+ * Note: Content/keyword search is not supported (content is encrypted).
+ */
+export type SearchCriteria = {
+    /**
+     * Match objects with paths starting with this prefix
+     * e.g., "/user/keeta1abc.../contacts/"
+     */
+    pathPrefix?: string;
+    /**
+     * Match objects that have ANY of these tags
+     */
+    tags?: string[];
+    /**
+     * Match path segment (filename portion)
+     */
+    name?: string;
+    /**
+     * Filter by owner's public key
+     */
+    owner?: string;
+    /**
+     * Include objects in nested paths (default: false)
+     */
+    recursive?: boolean;
+    /**
+     * Filter by visibility.
+     * When 'public', allows searching public objects outside caller's namespace.
+     */
+    visibility?: StorageObjectVisibility;
+};
+/**
+ * Pagination options for search
+ */
+export type SearchPagination = {
+    /**
+     * Cursor for pagination (from previous response)
+     */
+    cursor?: string;
+    /**
+     * Maximum number of results to return
+     */
+    limit?: number;
+};
+/**
+ * Search results with pagination
+ */
+export type SearchResults = {
+    /**
+     * Matching objects
+     */
+    results: StorageObjectMetadata[];
+    /**
+     * Cursor for next page (undefined if no more results)
+     */
+    nextCursor?: string;
+};
+/**
+ * Quota configuration for the storage service
+ */
+export type QuotaConfig = {
+    /**
+     * Maximum size in bytes per object
+     */
+    maxObjectSize: number;
+    /**
+     * Maximum number of objects per user
+     */
+    maxObjectsPerUser: number;
+    /**
+     * Maximum total storage in bytes per user
+     */
+    maxStoragePerUser: number;
+    /**
+     * Maximum number of results per search request
+     */
+    maxSearchLimit: number;
+    /**
+     * Maximum TTL in seconds for signed URLs
+     */
+    maxSignedUrlTTL: number;
+};
+/**
+ * Per-user quota limits.
+ * Subset of QuotaConfig that can be overridden on a per-user basis.
+ */
+export type QuotaLimits = Pick<QuotaConfig, 'maxObjectsPerUser' | 'maxStoragePerUser' | 'maxObjectSize'>;
+/**
+ * Current quota status for a user.
+ * Backends must provide objectCount and totalSize.
+ */
+export type QuotaStatus = {
+    /**
+     * Current number of objects
+     */
+    objectCount: number;
+    /**
+     * Current total size in bytes
+     */
+    totalSize: number;
+    /**
+     * Remaining objects allowed (optional, server computes if absent)
+     */
+    remainingObjects?: number;
+    /**
+     * Remaining storage in bytes (optional, server computes if absent)
+     */
+    remainingSize?: number;
+};
+/**
+ * Client-side request to put (create/update) an object
+ */
+export type KeetaStorageAnchorPutClientRequest = {
+    account?: KeetaNetAccount;
+    path: string;
+    data: string;
+    tags?: string[];
+    visibility?: StorageObjectVisibility;
+};
+/**
+ * Server-side request to put an object
+ */
+export type KeetaStorageAnchorPutRequest = {
+    account?: string;
+    signed?: HTTPSignedField;
+    path: string;
+    data: string;
+    tags?: string[];
+    visibility?: StorageObjectVisibility;
+};
+/**
+ * Configuration for a contacts client.
+ * Contacts are stored in a subdirectory of the account's working directory.
+ */
+export type ContactsClientConfig = {
+    /**
+     * The account to use for the contacts client.
+     */
+    account: KeetaNetAccount;
+    /**
+     * The base path for the contacts client.
+     */
+    basePath: string;
+};
+/**
+ * Generic response type for storage operations.
+ */
+export type StorageResponse<T> = ({
+    ok: true;
+} & T) | {
+    ok: false;
+    error: string;
+};
+export type KeetaStorageAnchorPutResponse = StorageResponse<{
+    object: StorageObjectMetadata;
+}>;
+export declare function getKeetaStorageAnchorPutRequestSigningData(input: {
+    path: string;
+    visibility?: StorageObjectVisibility;
+    tags?: string[];
+}): Signable;
+/**
+ * Client-side request to get an object
+ */
+export type KeetaStorageAnchorGetClientRequest = {
+    account?: KeetaNetAccount;
+    path: string;
+};
+/**
+ * Server-side request to get an object
+ */
+export type KeetaStorageAnchorGetRequest = {
+    account?: string;
+    signed?: HTTPSignedField;
+    path: string;
+};
+export type KeetaStorageAnchorGetResponse = StorageResponse<{
+    data: string;
+    object: StorageObjectMetadata;
+}>;
+export declare function getKeetaStorageAnchorGetRequestSigningData(input: KeetaStorageAnchorGetRequest): Signable;
+/**
+ * Client-side request to delete an object
+ */
+export type KeetaStorageAnchorDeleteClientRequest = {
+    account?: KeetaNetAccount;
+    /**
+     * Path to the object
+     */
+    path: string;
+};
+/**
+ * Server-side request to delete an object
+ */
+export type KeetaStorageAnchorDeleteRequest = {
+    account?: string;
+    signed?: HTTPSignedField;
+    /**
+     * Path to the object
+     */
+    path: string;
+};
+export type KeetaStorageAnchorDeleteResponse = StorageResponse<{
+    deleted: boolean;
+}>;
+export declare function getKeetaStorageAnchorDeleteRequestSigningData(input: KeetaStorageAnchorDeleteRequest): Signable;
+/**
+ * Client-side request to search objects
+ */
+export type KeetaStorageAnchorSearchClientRequest = {
+    account?: KeetaNetAccount;
+    criteria: SearchCriteria;
+    pagination?: SearchPagination;
+};
+/**
+ * Server-side request to search objects
+ */
+export type KeetaStorageAnchorSearchRequest = {
+    account?: string;
+    signed?: HTTPSignedField;
+    criteria: SearchCriteria;
+    pagination?: SearchPagination;
+};
+export type KeetaStorageAnchorSearchResponse = StorageResponse<{
+    results: StorageObjectMetadata[];
+    nextCursor?: string;
+}>;
+export declare function getKeetaStorageAnchorSearchRequestSigningData(input: KeetaStorageAnchorSearchRequest): Signable;
+/**
+ * Client-side request to get quota status
+ */
+export type KeetaStorageAnchorQuotaClientRequest = {
+    account?: KeetaNetAccount;
+};
+/**
+ * Server-side request to get quota status
+ */
+export type KeetaStorageAnchorQuotaRequest = {
+    account?: string;
+    signed?: HTTPSignedField;
+};
+export type KeetaStorageAnchorQuotaResponse = StorageResponse<{
+    quota: QuotaStatus;
+}>;
+/**
+ * Get signing data for quota requests.
+ * The input is unused because quota requests don't need request-specific signing -
+ * authentication alone is sufficient.
+ *
+ * The parameter was kept for API consistency with other signing functions.
+ */
+export declare function getKeetaStorageAnchorQuotaRequestSigningData(_ignoreInput: KeetaStorageAnchorQuotaRequest): Signable;
+declare class KeetaStorageAnchorDocumentNotFoundError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorDocumentNotFoundErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorDocumentNotFoundErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorDocumentNotFoundError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorDocumentNotFoundError>;
+}
+declare class KeetaStorageAnchorAccessDeniedError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorAccessDeniedErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorAccessDeniedErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorAccessDeniedError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorAccessDeniedError>;
+}
+declare class KeetaStorageAnchorInvalidPathError extends KeetaAnchorUserValidationError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorInvalidPathErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorInvalidPathErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorInvalidPathError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorInvalidPathError>;
+}
+type QuotaExceededType = 'maxObjectSize' | 'maxObjectsPerUser' | 'maxStoragePerUser';
+declare class KeetaStorageAnchorQuotaExceededError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorQuotaExceededErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorQuotaExceededErrorObjectTypeID;
+    /** Which quota limit was exceeded */
+    readonly quotaType: QuotaExceededType;
+    /** The configured maximum for the exceeded quota */
+    readonly limit: number;
+    /** The current or attempted value that exceeded the limit */
+    readonly current: number;
+    constructor(options: {
+        quotaType: QuotaExceededType;
+        limit: number;
+        current: number;
+        message?: string;
+    });
+    static isInstance(input: unknown): input is KeetaStorageAnchorQuotaExceededError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorQuotaExceededError>;
+}
+declare class KeetaStorageAnchorPrincipalRequiredError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorPrincipalRequiredErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorPrincipalRequiredErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorPrincipalRequiredError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorPrincipalRequiredError>;
+}
+declare class KeetaStorageAnchorValidationFailedError extends KeetaAnchorUserValidationError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorValidationFailedErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorValidationFailedErrorObjectTypeID;
+    constructor(message?: string);
+    get statusCode(): number;
+    static isInstance(input: unknown): input is KeetaStorageAnchorValidationFailedError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorValidationFailedError>;
+}
+declare class KeetaStorageAnchorSignatureExpiredError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorSignatureExpiredErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorSignatureExpiredErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorSignatureExpiredError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorSignatureExpiredError>;
+}
+declare class KeetaStorageAnchorSignatureInvalidError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorSignatureInvalidErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorSignatureInvalidErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorSignatureInvalidError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorSignatureInvalidError>;
+}
+declare class KeetaStorageAnchorPrivateKeyRequiredError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorPrivateKeyRequiredErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorPrivateKeyRequiredErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorPrivateKeyRequiredError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorPrivateKeyRequiredError>;
+}
+declare class KeetaStorageAnchorServiceUnavailableError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorServiceUnavailableErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorServiceUnavailableErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorServiceUnavailableError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorServiceUnavailableError>;
+}
+declare class KeetaStorageAnchorSignerRequiredError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorSignerRequiredErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorSignerRequiredErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorSignerRequiredError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorSignerRequiredError>;
+}
+declare class KeetaStorageAnchorAccountRequiredError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorAccountRequiredErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorAccountRequiredErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorAccountRequiredError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorAccountRequiredError>;
+}
+declare class KeetaStorageAnchorOperationNotSupportedError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorOperationNotSupportedErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorOperationNotSupportedErrorObjectTypeID;
+    constructor(operation?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorOperationNotSupportedError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorOperationNotSupportedError>;
+}
+declare class KeetaStorageAnchorUnsupportedAuthMethodError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorUnsupportedAuthMethodErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorUnsupportedAuthMethodErrorObjectTypeID;
+    constructor(method?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorUnsupportedAuthMethodError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorUnsupportedAuthMethodError>;
+}
+declare class KeetaStorageAnchorInvalidResponseError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorInvalidResponseErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorInvalidResponseErrorObjectTypeID;
+    constructor(details?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorInvalidResponseError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorInvalidResponseError>;
+}
+declare class KeetaStorageAnchorInvalidAnchorAccountError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorInvalidAnchorAccountErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorInvalidAnchorAccountErrorObjectTypeID;
+    constructor(publicKey?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorInvalidAnchorAccountError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorInvalidAnchorAccountError>;
+}
+declare class KeetaStorageAnchorInvariantViolationError extends KeetaAnchorUserError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorInvariantViolationErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorInvariantViolationErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorInvariantViolationError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorInvariantViolationError>;
+}
+declare class KeetaStorageAnchorInvalidTagError extends KeetaAnchorUserValidationError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorInvalidTagErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorInvalidTagErrorObjectTypeID;
+    constructor(message?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorInvalidTagError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorInvalidTagError>;
+}
+declare class KeetaStorageAnchorInvalidMetadataError extends KeetaAnchorUserValidationError {
+    static readonly name: string;
+    private readonly KeetaStorageAnchorInvalidMetadataErrorObjectTypeID;
+    private static readonly KeetaStorageAnchorInvalidMetadataErrorObjectTypeID;
+    constructor(reason?: string);
+    static isInstance(input: unknown): input is KeetaStorageAnchorInvalidMetadataError;
+    static fromJSON(input: unknown): Promise<KeetaStorageAnchorInvalidMetadataError>;
+}
+export declare const Errors: {
+    DocumentNotFound: typeof KeetaStorageAnchorDocumentNotFoundError;
+    AccessDenied: typeof KeetaStorageAnchorAccessDeniedError;
+    InvalidPath: typeof KeetaStorageAnchorInvalidPathError;
+    QuotaExceeded: typeof KeetaStorageAnchorQuotaExceededError;
+    AnchorPrincipalRequired: typeof KeetaStorageAnchorPrincipalRequiredError;
+    ValidationFailed: typeof KeetaStorageAnchorValidationFailedError;
+    SignatureExpired: typeof KeetaStorageAnchorSignatureExpiredError;
+    SignatureInvalid: typeof KeetaStorageAnchorSignatureInvalidError;
+    PrivateKeyRequired: typeof KeetaStorageAnchorPrivateKeyRequiredError;
+    ServiceUnavailable: typeof KeetaStorageAnchorServiceUnavailableError;
+    SignerRequired: typeof KeetaStorageAnchorSignerRequiredError;
+    AccountRequired: typeof KeetaStorageAnchorAccountRequiredError;
+    OperationNotSupported: typeof KeetaStorageAnchorOperationNotSupportedError;
+    UnsupportedAuthMethod: typeof KeetaStorageAnchorUnsupportedAuthMethodError;
+    InvalidResponse: typeof KeetaStorageAnchorInvalidResponseError;
+    InvalidAnchorAccount: typeof KeetaStorageAnchorInvalidAnchorAccountError;
+    InvariantViolation: typeof KeetaStorageAnchorInvariantViolationError;
+    InvalidTag: typeof KeetaStorageAnchorInvalidTagError;
+    InvalidMetadata: typeof KeetaStorageAnchorInvalidMetadataError;
+};
+/**
+ * Metadata input for put operations.
+ * Provided by the client when storing an object.
+ */
+export type StoragePutMetadata = {
+    /** Owner's identifier */
+    owner: string;
+    /** Tags for categorization and search */
+    tags: string[];
+    /** Access visibility setting */
+    visibility: StorageObjectVisibility;
+};
+/**
+ * Result of a get operation.
+ * Contains both the raw encrypted data and the object metadata.
+ */
+export type StorageGetResult = {
+    /** Raw encrypted data (EncryptedContainer) */
+    data: Buffer;
+    /** Object metadata */
+    metadata: StorageObjectMetadata;
+};
+/**
+ * Represents a pending upload quota reservation.
+ * Used to reserve quota before an upload and track in-flight uploads.
+ */
+export interface UploadReservation {
+    /** Unique identifier for this reservation */
+    id: string;
+    /** Owner's identifier */
+    owner: string;
+    /** Target path for the upload */
+    path: string;
+    /** Reserved size in bytes */
+    size: number;
+    /** When the reservation was created */
+    createdAt: string;
+    /** When the reservation expires - hint for stale cleanup */
+    expiresAt: string;
+}
+/**
+ * Core CRUD operations for storage.
+ * All backends must implement these operations.
+ */
+export interface StorageBackend {
+    /**
+     * Store/update an object at the given path
+     */
+    put(path: string, data: Buffer, metadata: StoragePutMetadata): Promise<StorageObjectMetadata>;
+    /**
+     * Retrieve an object by path
+     */
+    get(path: string): Promise<StorageGetResult | null>;
+    /**
+     * Delete an object by path
+     */
+    delete(path: string): Promise<boolean>;
+}
+/**
+ * Search capability interface.
+ * Optional for backends that don't support indexing (e.g., simple S3-only backends).
+ */
+export interface SearchableStorage {
+    /**
+     * Search for objects matching criteria
+     */
+    search(criteria: SearchCriteria, pagination: SearchPagination): Promise<SearchResults>;
+}
+/**
+ * Quota management with upload reservations.
+ * Handles quota tracking and reservation-based upload flow.
+ */
+export interface QuotaManagedStorage {
+    /**
+     * Get quota status for a user.
+     * Includes both actual usage and pending reservations.
+     */
+    getQuotaStatus(owner: string): Promise<QuotaStatus>;
+    /**
+     * Get per-user quota limits.
+     * Return null to use global defaults.
+     * @param owner - Owner's identifier
+     */
+    getQuotaLimits?(owner: string): Promise<QuotaLimits | null>;
+    /**
+     * Reserve quota for an upcoming upload.
+     *
+     * @param owner - Owner's identifier
+     * @param path - Target path for the upload
+     * @param size - Size in bytes to reserve
+     * @param options.ttlMs - Optional TTL in milliseconds for the reservation
+     * @param options.quotaLimits - Optional quota limits to enforce (overrides backend defaults)
+     *
+     * @returns Reservation that must be committed or released
+     *
+     * @throws QuotaExceeded if reservation would exceed limits
+     */
+    reserveUpload(owner: string, path: string, size: number, options?: {
+        ttlMs?: number;
+        quotaLimits?: Pick<QuotaConfig, 'maxObjectsPerUser' | 'maxStoragePerUser'>;
+    }): Promise<UploadReservation>;
+    /**
+     * Commit a reservation after successful upload.
+     * Call after put() succeeds to finalize the quota usage.
+     * @param reservationId - ID of the reservation to commit
+     */
+    commitUpload(reservationId: string): Promise<void>;
+    /**
+     * Release a reservation (upload failed or cancelled).
+     * Frees the reserved quota.
+     * @param reservationId - ID of the reservation to release
+     */
+    releaseUpload(reservationId: string): Promise<void>;
+}
+/**
+ * Full storage backend combining all capabilities.
+ * Use this type when a backend supports CRUD, search, and quota management.
+ */
+export type FullStorageBackend = StorageBackend & SearchableStorage & QuotaManagedStorage;
+/**
+ * Generic interface for path policies.
+ * Each implementation defines its own parsed type and access control logic.
+ * Storage Anchors are free to implement whatever pathname structure they wish.
+ */
+export interface PathPolicy<TPathInfo> {
+    /**
+     * Parse a path into its components.
+     * @returns TPathInfo if valid, null otherwise
+     */
+    parse(path: string): TPathInfo | null;
+    /**
+     * Validate a path and return its components.
+     * @throws Errors.InvalidPath if the path is invalid
+     */
+    validate(path: string): TPathInfo;
+    /**
+     * Check if a path is valid.
+     */
+    isValid(path: string): boolean;
+    /**
+     * Check if the account has access to perform the operation on the parsed path.
+     * @returns true if access is allowed, false otherwise
+     */
+    checkAccess(account: KeetaNetAccount, parsed: TPathInfo, operation: 'get' | 'put' | 'delete' | 'search' | 'metadata'): boolean;
+    /**
+     * Get the account authorized to sign pre-signed URLs for this path.
+     * Used for public object access verification.
+     *
+     * @returns The account if only that account can sign (owner-restricted), or `null` if any account can sign
+     */
+    getAuthorizedSigner(parsed: TPathInfo): KeetaNetAccount | null;
+    /**
+     * Validate metadata for a path.
+     * Called during PUT and metadata update operations.
+     * @param parsed - The parsed path info
+     * @param metadata - The metadata to validate
+     * @throws Errors.InvalidMetadata if metadata violates path constraints
+     */
+    validateMetadata?(parsed: TPathInfo, metadata: StoragePutMetadata): void;
+}
+/**
+ * Parse the decrypted plaintext from an EncryptedContainer.
+ * The payload is expected to be JSON with mimeType and base64-encoded data,
+ * keeping the mimeType encrypted along with the content.
+ *
+ * @param plaintext - The decrypted plaintext from an EncryptedContainer
+ *
+ * @returns Object containing mimeType and content Buffer
+ */
+export declare function parseContainerPayload(plaintext: ArrayBuffer): {
+    mimeType: string;
+    content: Buffer;
+};
+export {};
+//# sourceMappingURL=common.d.ts.map

package/services/storage/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/services/storage/common.ts"],"names":[],"mappings":"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"}