@gajae-code/natives 0.15.2 → 0.15.3

package/native/index.d.ts

@@ -212,7 +212,7 @@ export declare class NotificationServer {
    * # Errors
    * Fails if not started or `frame_json` is not a valid `ServerMessage`.
    */
-  pushFrame(frameJson: string): void
+  pushFrame(frameJson: string, excludedConnectionIds?: Array<string> | undefined | null): void
   /**
    * Deliver a frame through every authenticated connection and wait for each
    * socket writer to settle within `timeout_ms`.
@@ -220,22 +220,40 @@ export declare class NotificationServer {
   pushFrameAndWait(frameJson: string, timeoutMs: number): Promise<boolean>
   /**
    * Broadcast a TypeScript-constructed turn frame without re-parsing JSON.
-   * External frames must continue through [`Self::push_frame`] for serde
-   * validation.
+   * Returns whether at least one non-excluded transport accepted the raw
+   * frame. External frames must continue through [`Self::push_frame`] for
+   * serde validation.
    */
-  pushTurnStreamUnchecked(sessionId: string, phase: string, text: string, finalAnswer?: boolean | undefined | null, messageRef?: string | undefined | null): void
+  pushTurnStreamUnchecked(sessionId: string, phase: string, text: string, finalAnswer?: boolean | undefined | null, messageRef?: string | undefined | null, excludedConnectionIds?: Array<string> | undefined | null): boolean
   /**
    * Broadcast a file attachment from raw N-API bytes, encoding the unchanged
    * base64 wire field only in Rust.
    */
-  pushFileAttachmentUnchecked(sessionId: string, name: string, mime: string | undefined | null, data: Buffer, caption?: string | undefined | null): void
+  pushFileAttachmentUnchecked(sessionId: string, name: string, mime: string | undefined | null, data: Buffer, caption?: string | undefined | null, excludedConnectionIds?: Array<string> | undefined | null): void
   /**
    * Return counters guarding the known-good frame crossing against
    * regressions.
    */
   knownGoodFrameStats(): KnownGoodFrameStats
+  /**
+   * Proves that the loaded addon honors positioned-recipient exclusions on
+   * raw notification fan-out. Kept as an explicit executable capability so a
+   * stale linked addon cannot silently accept and ignore the optional N-API
+   * arguments.
+   */
+  supportsPositionedRawExclusion(): boolean
   /** Send a validated, bounded JSON envelope to one connected v3 SDK client. */
   sendTo(connectionId: string, json: string): void
+  /**
+   * Send a directed frame and return an opaque receipt bound to the exact
+   * connection generation that accepted it.
+   */
+  sendToWithReceipt(connectionId: string, json: string): string
+  /**
+   * Queue an idle action only on writer generations that also accepted its
+   * positioned or raw identity prerequisite.
+   */
+  queueIdleAfterDirected(prerequisiteJson: string, positionedReceipts: Array<string>, neededJson: string): DependentIdleDeliveryResult
   /**
    * Publish a replayable `session_ready` readiness signal. `ready_json` is a
    * JSON `SessionReady`. Unlike [`Self::push_frame`], this frame is buffered
@@ -526,7 +544,7 @@ export declare function __piNativesPublishOutcomeV1(): void
  * `packages/natives/native/index.js` (which derives the name from
  * `package.json#version`).
  */
-export declare function __piNativesV0_15_2(): void
+export declare function __piNativesV0_15_3(): void
 
 /**
  * Apply conservative pre-execution rewrites to a bash command.
@@ -831,6 +849,13 @@ export declare function copyToClipboard(text: string): void
  */
 export declare function currentExecutablePath(): string | null
 
+/** Explicit result of binding an idle action to an exact prerequisite cohort. */
+export interface DependentIdleDeliveryResult {
+  status: 'queued' | 'no_recipients' | 'rejected' | 'partial'
+  recipientCount: number
+  queuedCount: number
+}
+
 /**
  * Detect macOS system appearance via CoreFoundation.
  * Returns `"dark"` or `"light"` on macOS, `null` on other platforms.

package/native/index.js

@@ -30,7 +30,7 @@ export const Shell = nativeBindings.Shell;
 
 // functions
 export const __piNativesPublishOutcomeV1 = nativeBindings.__piNativesPublishOutcomeV1;
-export const __piNativesV0_15_2 = nativeBindings.__piNativesV0_15_2;
+export const __piNativesV0_15_3 = nativeBindings.__piNativesV0_15_3;
 export const applyBashFixups = nativeBindings.applyBashFixups;
 export const applyOwnerOnlyFdSecurity = nativeBindings.applyOwnerOnlyFdSecurity;
 export const applyOwnerOnlyPathSecurity = nativeBindings.applyOwnerOnlyPathSecurity;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gajae-code/natives",
-	"version": "0.15.2",
+	"version": "0.15.3",
 	"description": "Native Rust bindings for grep, clipboard, image processing, syntax highlighting, PTY, and shell operations via N-API",
 	"type": "module",
 	"homepage": "https://gajae-code.com",
@@ -61,11 +61,11 @@
 		"README.md"
 	],
 	"optionalDependencies": {
-		"@gajae-code/natives-darwin-arm64": "0.15.2",
-		"@gajae-code/natives-darwin-x64": "0.15.2",
-		"@gajae-code/natives-linux-arm64": "0.15.2",
-		"@gajae-code/natives-linux-x64": "0.15.2",
-		"@gajae-code/natives-win32-x64": "0.15.2"
+		"@gajae-code/natives-darwin-arm64": "0.15.3",
+		"@gajae-code/natives-darwin-x64": "0.15.3",
+		"@gajae-code/natives-linux-arm64": "0.15.3",
+		"@gajae-code/natives-linux-x64": "0.15.3",
+		"@gajae-code/natives-win32-x64": "0.15.3"
 	},
 	"exports": {
 		".": {