@byok-sdk/core 0.31.0 → 0.33.0

package/dist/board.d.ts

@@ -117,4 +117,6 @@ export interface BoardStore {
     claim(tenant: TenantId, input: BoardClaimInput): Promise<BoardItem>;
     unclaim(tenant: TenantId, input: BoardUnclaimInput): Promise<BoardItem>;
     updateStatus(tenant: TenantId, input: BoardStatusUpdateInput): Promise<BoardItem>;
+    /** Removes the item; an absent item is not an error. The Host archive step (#1120) is the caller. */
+    remove(tenant: TenantId, itemId: string): Promise<void>;
 }

package/dist/errors.d.ts

@@ -47,6 +47,7 @@ export declare const CORE_ERROR_CODES: {
     readonly mailbox_message_not_found: 'mailbox_message_not_found';
     readonly mailbox_cursor_regression: 'mailbox_cursor_regression';
     readonly mailbox_cursor_ahead_of_delivery: 'mailbox_cursor_ahead_of_delivery';
+    readonly mailbox_stream_closed: 'mailbox_stream_closed';
     readonly board_item_not_found: 'board_item_not_found';
     readonly board_item_exists: 'board_item_exists';
     readonly board_transition_invalid: 'board_transition_invalid';

package/dist/in-memory/archive-access.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Archive access to the in-memory core stores (#1120).
+ *
+ * The Host task archive in `@byok-sdk/cloud` rewrites acked and expired mailbox
+ * bodies and removes object references in one synchronous step, which the
+ * async ports cannot express. Adding methods to the port classes would put
+ * them in the port inventory, and exporting functions would put them in this
+ * package's API. Each in-memory store instead registers its access here, keyed
+ * by the store instance, in a registry under a well-known global symbol. The
+ * cloud package reads the same registry by the same key. Nothing here is
+ * exported from the package entry.
+ */
+import type { MailboxBody, MailboxMessage } from '../mailbox';
+import type { TenantId } from '../tenant';
+export interface InMemoryMailboxArchiveAccess {
+    /** The retained rows of one device. */
+    messagesOf(tenant: TenantId, deviceId: string): readonly MailboxMessage[];
+    /** Replaces one retained row's body. The row, its seq and its state stay. */
+    replaceBody(tenant: TenantId, deviceId: string, seq: number, body: MailboxBody): void;
+}
+export interface InMemoryObjectArchiveAccess {
+    /** Removes every reference `(refKind, refId)` holds and returns how many went. */
+    releaseReferences(tenant: TenantId, refKind: string, refId: string): number;
+}
+export declare function registerArchiveAccess(store: object, access: InMemoryMailboxArchiveAccess | InMemoryObjectArchiveAccess): void;

package/dist/in-memory/board.d.ts

@@ -20,6 +20,7 @@ export declare class InMemoryBoardStore implements BoardStore {
     create(tenant: TenantId, input: BoardItemInput): Promise<BoardItem>;
     get(tenant: TenantId, itemId: string): Promise<BoardItem | undefined>;
     list(tenant: TenantId, query: BoardListQuery): Promise<BoardPage>;
+    remove(tenant: TenantId, itemId: string): Promise<void>;
     claim(tenant: TenantId, input: BoardClaimInput): Promise<BoardItem>;
     unclaim(tenant: TenantId, input: BoardUnclaimInput): Promise<BoardItem>;
     updateStatus(tenant: TenantId, input: BoardStatusUpdateInput): Promise<BoardItem>;

package/dist/in-memory/mailbox.d.ts

@@ -1,5 +1,5 @@
 import { type CollectExpiredResult } from '../retention';
-import type { MailboxAdvanceCursorInput, MailboxAppendInput, MailboxCursorState, MailboxMessage, MailboxPage, MailboxReadQuery, MailboxRecordDeliveryInput, MailboxCollectExpiredInput, MailboxStore, MailboxUsage } from '../mailbox';
+import type { MailboxAdvanceCursorInput, MailboxAppendInput, MailboxCloseStreamInput, MailboxCursorState, MailboxMessage, MailboxPage, MailboxReadQuery, MailboxRecordDeliveryInput, MailboxCollectExpiredInput, MailboxExpirePendingInput, MailboxReopenStreamInput, MailboxStore, MailboxUsage } from '../mailbox';
 import type { QuotaStore } from '../quota';
 import type { Clock } from '../stores';
 import { type TenantId } from '../tenant';
@@ -14,4 +14,11 @@ export declare class InMemoryMailboxStore implements MailboxStore {
     recordDelivery(tenant: TenantId, input: MailboxRecordDeliveryInput): Promise<MailboxCursorState>;
     readCursor(tenant: TenantId, deviceId: string): Promise<MailboxCursorState>;
     collectExpired(tenant: TenantId, input: MailboxCollectExpiredInput): Promise<CollectExpiredResult>;
+    expirePending(tenant: TenantId, input: MailboxExpirePendingInput): Promise<{
+        readonly expired: number;
+    }>;
+    closeStream(tenant: TenantId, input: MailboxCloseStreamInput): Promise<{
+        readonly expired: number;
+    }>;
+    reopenStream(tenant: TenantId, input: MailboxReopenStreamInput): Promise<void>;
 }

package/dist/index.d.ts

@@ -19,14 +19,14 @@ export type { ControlPlanePrincipal, DevicePrincipal, Principal, PrincipalKind,
 export { ByokCoreError, CoreConflictError, CORE_ERROR_CODES, isCoreError, isCoreConflictError } from './errors';
 export type { CoreErrorCode } from './errors';
 export { CANONICAL_TIMESTAMP_PATTERN, assertCanonicalTimestamp, isCanonicalTimestamp, } from './time';
-export { MAILBOX_MESSAGE_STATES } from './mailbox';
-export type { MailboxAdmission, MailboxAdvanceCursorInput, MailboxAppendInput, MailboxBody, MailboxCursorState, MailboxMessage, MailboxMessageState, MailboxPage, MailboxReadQuery, MailboxRecordDeliveryInput, MailboxCollectExpiredInput, MailboxStore, MailboxUsage, } from './mailbox';
+export { MAILBOX_MESSAGE_STATES, MAILBOX_STREAM_CLOSE_CAUSES, MailboxStreamClosedError } from './mailbox';
+export type { MailboxAdmission, MailboxAdvanceCursorInput, MailboxAppendInput, MailboxBody, MailboxCursorState, MailboxMessage, MailboxMessageState, MailboxPage, MailboxReadQuery, MailboxRecordDeliveryInput, MailboxCloseStreamInput, MailboxCollectExpiredInput, MailboxExpirePendingInput, MailboxReopenStreamInput, MailboxStreamCloseCause, MailboxStore, MailboxUsage, } from './mailbox';
 export { BOARD_STATUSES, BOARD_TRANSITIONS, isLegalBoardTransition } from './board';
 export type { BoardAssignee, BoardClaimInput, BoardItem, BoardItemInput, BoardListQuery, BoardPage, BoardStatus, BoardStatusUpdateInput, BoardStore, BoardUnclaimInput, } from './board';
 export { TRUTH_RECORD_KINDS } from './truth';
 export type { SnapshotWriteInput, TerminalWriteInput, TruthBodyRef, TruthManifestEntry, TruthManifestQuery, TruthRecord, TruthRecordKind, TruthRecordSelector, TruthStore, } from './truth';
-export { PRESENCE_LEVELS } from './presence';
-export type { PresenceHint, PresenceHintInput, PresenceLevel, PresenceRuntimeFact, PresenceStore, TenantReadinessDevice, TenantReadinessPresence, TenantReadiness, } from './presence';
+export { freezePresenceRuntimeFact, PRESENCE_LEVELS } from './presence';
+export type { PresenceHint, PresenceHintInput, PresenceLevel, PresenceRuntimeCapabilities, PresenceRuntimeFact, PresenceStore, TenantReadinessDevice, TenantReadinessPresence, TenantReadiness, } from './presence';
 export { CONTENT_HASH_PATTERN, OBJECT_KEY_PREFIX_PATTERN, OBJECT_STATES, OBJECT_STATE_TRANSITIONS, contentHash, isContentHash, isLegalObjectTransition, objectKeyPrefix, tenantObjectKey, } from './blob';
 export type { ContentHash, ObjectCommitInput, ObjectKeyPrefix, ObjectListQuery, ObjectManifestEntry, ObjectManifestInput, ObjectReference, ObjectReferenceInput, ObjectState, ObjectStore, } from './blob';
 export { STORAGE_ERROR_CODES, STORAGE_ERROR_HTTP_STATUS, STORAGE_RESERVATION_STATES, STORAGE_WRITE_KINDS, STORAGE_WRITE_POSTURES, } from './quota';
@@ -54,6 +54,7 @@ export { assertCollectExpiredInput, CollectExpiredFailure } from './retention';
 export type { CollectExpiredInput, CollectExpiredCounts, CollectExpiredResult } from './retention';
 export type { QuotaCollectExpiredInput } from './quota';
 export type { ObjectCollectExpiredInput } from './blob';
+export type { LocalStoreId, StoreCompatibility, StoreCompatibilityVerdict } from './store-compatibility';
 export { InMemoryStorageLedger } from './in-memory/storage-ledger';
 export type { InMemoryObjectBytes } from './in-memory/blob';
 export * from './routine-schedule';