@pinet/pinet-core 0.2.2 → 0.2.6

package/README.md

@@ -1,20 +1,26 @@
 # @pinet/pinet-core
 
-Runtime-core helpers for Pinet that are independent of any Slack adapter.
+Runtime helpers for Pinet that work independently of Slack.
 
-Current seam:
+## What it does
 
-- Pinet output option normalization (`cli` default, explicit `json`/`full` opt-ins)
-- durable Pinet read result text/detail formatting
-- scheduled wake-up time parsing and thread ID helpers
+This package provides:
 
-`@pinet/slack-bridge` still composes the extension and preserves compatibility wrappers, but these helpers now live behind package exports so future extraction can move one boundary at a time.
+- output option normalisation (defaults to `cli`, accepts `json` or `full`)
+- durable read result formatting
+- scheduled wake-up time parsing
+- thread ID helpers
 
-Design proposal: `plans/slack-split-proposal.md`
+## How it works
+
+The package exports helpers that `@pinet/slack-bridge` uses internally. These functions handle Pinet operations without depending on Slack adapters.
+
+The helpers live behind package exports. Future changes can move functionality one boundary at a time.
+
+See the design proposal in `plans/slack-split-proposal.md`.
 
 ## Publishing
 
-This package is included in the full npm publish set tracked in
-[`../plans/npm-publish.md`](../plans/npm-publish.md). Use the GitHub Actions
-workflow's default dry-run/readiness path for validation; do not publish, tag, or
-bump versions without explicit maintainer release approval.
+This package is part of the npm publish set in [`../plans/npm-publish.md`](../plans/npm-publish.md).
+
+Do not publish, tag, or bump versions without maintainer approval. Use the GitHub Actions workflow for validation.

package/dist/output-options.d.ts

@@ -1,6 +1,16 @@
 export type PinetOutputFormat = "cli" | "json";
+type PinetOutputFormatInput = string | number | boolean | null | undefined;
+type PinetOutputFullInput = boolean | string | number | null | undefined;
+export interface PinetOutputOptionsArgs {
+    format?: PinetOutputFormatInput;
+    f?: PinetOutputFormatInput;
+    "-f"?: PinetOutputFormatInput;
+    full?: PinetOutputFullInput;
+    "--full"?: PinetOutputFullInput;
+}
 export interface PinetOutputOptions {
     format: PinetOutputFormat;
     full: boolean;
 }
-export declare function normalizePinetOutputOptions(args: Record<string, unknown>): PinetOutputOptions;
+export declare function normalizePinetOutputOptions(args: PinetOutputOptionsArgs): PinetOutputOptions;
+export {};

package/dist/pinet-read-formatting.d.ts

@@ -1,4 +1,8 @@
 import { type PinetMailClass } from "@pinet/broker-core/mail-classification";
+export type PinetReadMetadataValue = unknown;
+export interface PinetReadMessageMetadata {
+    [key: string]: PinetReadMetadataValue;
+}
 export interface PinetInboxItem {
     inboxId: number;
     delivered: boolean;
@@ -10,7 +14,7 @@ export interface PinetInboxItem {
         direction: string;
         sender: string;
         body: string;
-        metadata: Record<string, unknown> | null;
+        metadata: PinetReadMessageMetadata | null;
         createdAt: string;
     };
 }
@@ -43,7 +47,34 @@ export interface PinetReadOptions {
     unreadOnly?: boolean;
     markRead?: boolean;
 }
+export interface CompactPinetReadMessageDetails {
+    id: number;
+    threadId: string;
+    source: string;
+    sender: string;
+    class: PinetMailClass;
+}
+export interface CompactPinetReadUnreadThreadDetails {
+    threadId: string;
+    source: string;
+    unread: number;
+    latestMessageId: number;
+    class: PinetMailClass;
+    summary: string;
+}
+export interface CompactPinetReadDetails {
+    summary: string;
+    messageCount: number;
+    unreadBefore: number;
+    unreadAfter: number;
+    markedReadCount?: number;
+    messages?: CompactPinetReadMessageDetails[];
+    exactBodies?: string;
+    messagesTruncated?: number;
+    unreadThreads?: CompactPinetReadUnreadThreadDetails[];
+    unreadThreadsTruncated?: number;
+}
 export declare function formatPinetReadResultFull(result: PinetReadResult, options: PinetReadOptions): string;
 export declare function summarizeUnreadThreadCounts(thread: PinetUnreadThreadSummary): string;
-export declare function buildCompactPinetReadDetails(result: PinetReadResult): Record<string, unknown>;
+export declare function buildCompactPinetReadDetails(result: PinetReadResult): CompactPinetReadDetails;
 export declare function formatPinetReadResultCompact(result: PinetReadResult, options: PinetReadOptions): string;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@pinet/pinet-core",
-  "version": "0.2.2",
+  "version": "0.2.6",
   "type": "module",
   "description": "Pinet runtime core for pi — broker/follower orchestration and mesh tooling",
   "author": "Will Porcellini <5994936+gugu91@users.noreply.github.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/gugu91/extensions.git",
+    "url": "git+https://github.com/gugu91/pinet.git",
     "directory": "pinet-core"
   },
   "publishConfig": {
@@ -30,13 +30,13 @@
   "scripts": {
     "build": "node ../scripts/build-package.mjs",
     "prepack": "pnpm run build",
-    "lint": "eslint . --ext .ts",
+    "lint": "oxlint .",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run *.test.ts"
+    "test": "vitest run --config ../vitest.config.ts *.test.ts"
   },
   "dependencies": {
-    "@pinet/broker-core": "0.2.2",
-    "@pinet/transport-core": "0.2.2"
+    "@pinet/broker-core": "0.2.6",
+    "@pinet/transport-core": "0.2.6"
   },
   "types": "./dist/index.d.ts"
 }