coakka-v2-connector-electron 2.5.0 → 2.5.2

package/NATIVE-LICENSE.md

@@ -1,36 +1,35 @@
-# CoAkka Public Artifact License 1.1
+# CoAkka Native Artifact License 1.2
 
-Effective: 2026-08-03
+Effective: 2026-08-20
 
-This repository is the public binary artifact surface for CoAkka. It contains
-headers, native libraries, connector packages, Maven artifacts, checksums, and
-artifact metadata. It is not a source-build repository.
+This license applies only to CoAkka Native Artifacts that include or explicitly
+reference version 1.2 of these terms. It does not replace the terms shipped
+with an older release unless that release explicitly adopts version 1.2.
 
-Unless a specific artifact includes explicitly different license terms, the
-Licensor makes the Artifacts available under this license. Version 1.1 replaces
-version 1.0 for all Artifacts currently distributed from this repository or an
-official release page, including Artifacts first published before the effective
-date. An embedded copy of CoAkka Public Artifact License 1.0 is superseded by
-this version and is not an explicitly different artifact-specific license.
-
-This is a public-use artifact license, not an OSI-approved open source license.
-The separate `coakka-samples` repository may use a permissive open source
-license for sample code and documentation; that sample license does not change
-the terms for the Artifacts.
+This is a public-use native artifact license, not an OSI-approved open source
+license. Connector source, generated language bindings, type declarations,
+sample source, package documentation, and public documentation may be provided
+separately under the Apache License, Version 2.0. A package can therefore be a
+file-scoped multi-license distribution: Apache-2.0 for its language-level
+material and this license for its bundled Native Artifacts.
 
 ## Definitions
 
 `Licensor` means the copyright owner or entity authorized to distribute the
-Artifacts under this license.
+Native Artifacts under this license.
 
-`Artifacts` means the CoAkka binaries, headers, libraries, connector packages,
-Maven artifacts, container-bundle files, checksums, manifests, and release
-metadata distributed from this repository or an official release page.
+`Native Artifacts` means compiled CoAkka native libraries and executables,
+native headers required to consume them, native symbol or debug files, and
+native-only provenance, manifest, checksum, or signature material that includes
+or explicitly references this license. Connector source, generated language
+bindings, type declarations, examples, and documentation are not Native
+Artifacts merely because they are distributed in the same package.
 
-`Application` means a product or service that uses the Artifacts as an internal
-component to provide functionality independent from CoAkka. CoAkka is not the
-primary product offered to the application's users, and those users are not
-given a hosted CoAkka runtime or substantially equivalent CoAkka service.
+`Application` means a product or service that uses the Native Artifacts as an
+internal component to provide functionality independent from CoAkka. CoAkka is
+not the primary or substantial product offered to the application's users, and
+those users are not given a hosted CoAkka runtime or substantially equivalent
+CoAkka service.
 
 `Managed CoAkka Service` means a product or service offered to third parties
 whose primary or substantial value is providing hosted access to CoAkka's
@@ -40,24 +39,24 @@ service through which customers deploy or operate workloads directly against
 CoAkka, and an appliance or cloud image whose primary purpose is to provide
 CoAkka functionality.
 
-## License Grant And Allowed Use
+## Free Application Use
 
 Subject to this license, the Licensor grants you a non-exclusive, worldwide,
-royalty-free license to download, copy, and use the Artifacts, and to
-redistribute unmodified Artifacts as part of an Application.
+royalty-free license to download, copy, and use the Native Artifacts, and to
+redistribute unmodified Native Artifacts as part of an Application.
 
 You may, without a separate agreement:
 
-- use every capability included in an Artifact in development, test, CI,
+- use every capability included in a Native Artifact in development, test, CI,
   evaluation, proof-of-concept, and production environments
-- use the Artifacts for internal business operations and commercial workloads
+- use the Native Artifacts for internal business operations and commercial workloads
 - build, operate, sell, and distribute Applications that use or bundle
-  unmodified Artifacts
+  unmodified Native Artifacts
 - operate a SaaS, hosted application, or customer-facing service that uses the
-  Artifacts as an internal component, provided the offering is not a Managed
-  CoAkka Service
-- reproduce and cache unmodified Artifacts inside your organization and its
-  controlled build, deployment, and support environments
+  Native Artifacts as an internal component, provided the offering is not a
+  Managed CoAkka Service
+- reproduce and cache unmodified Native Artifacts inside your organization and
+  its controlled build, deployment, and support environments
 - run and internally cache official CoAkka sample images
 - provide integration, consulting, and support services for Applications that
   use CoAkka, provided those services do not offer a Managed CoAkka Service
@@ -68,29 +67,30 @@ use CoAkka internally and in its independent Applications on the same terms as
 any other user. The restriction below is based on what is offered to third
 parties, not on the identity of the user.
 
-When redistributing an Artifact with an Application, you must preserve the
-applicable copyright, license, trademark, checksum, and provenance notices and
-make a copy of this license available with the redistributed Artifact.
+When redistributing a Native Artifact with an Application, you must preserve
+the applicable copyright, license, trademark, checksum, and provenance notices
+and make a copy of this license available with the redistributed Native
+Artifact.
 
 ## Reserved Uses
 
 The following uses require a separate written agreement with the Licensor:
 
 - selling, hosting, or offering a Managed CoAkka Service
-- selling, licensing, renting, or redistributing the Artifacts as a standalone
-  product or where the Artifacts provide the primary or substantial value of
+- selling, licensing, renting, or redistributing the Native Artifacts as a
+  standalone product or where they provide the primary or substantial value of
   the offering
 - publishing an appliance, container image, cloud image, runtime platform, or
   marketplace offering whose primary purpose is to provide CoAkka functionality
-- presenting modified, repackaged, or third-party Artifacts as official CoAkka
-  Artifacts
+- presenting modified, repackaged, or third-party artifacts as official CoAkka
+  Native Artifacts
 
 You may not:
 
 - remove or obscure copyright, license, trademark, checksum, or provenance
   notices
-- reverse engineer or modify the Artifacts except where that restriction is
-  prohibited by applicable law
+- reverse engineer or modify the Native Artifacts except where that restriction
+  is prohibited by applicable law
 - use the CoAkka name, package names, artifact names, image names, or other
   project identifiers in a way that implies endorsement of an unofficial fork,
   hosted service, or product
@@ -100,33 +100,36 @@ You may not:
 This license states legal permissions and restrictions; it is not a runtime
 activation mechanism. Publisher signing, platform trust, checksums, release
 receipts, capability introspection, and runtime license-status fields do not
-create an additional feature or production-use fee for an Artifact distributed
-under this license. Local operating-system or organization security policy may
-still require its own signing, integrity, or admission checks.
+create an additional feature or production-use fee for a Native Artifact
+distributed under this license. Local operating-system or organization
+security policy may still require its own signing, integrity, or admission
+checks.
 
 ## No Warranty
 
-The Artifacts are provided as-is, without warranties or conditions of any kind,
-to the maximum extent permitted by applicable law.
+The Native Artifacts are provided as-is, without warranties or conditions of
+any kind, to the maximum extent permitted by applicable law.
 
 ## Limitation Of Liability
 
-To the maximum extent permitted by applicable law, the project contributors and
-artifact publishers are not liable for any direct, indirect, incidental,
+To the maximum extent permitted by applicable law, the project contributors
+and artifact publishers are not liable for any direct, indirect, incidental,
 special, consequential, exemplary, or other damages arising from use of the
-Artifacts.
+Native Artifacts.
 
 ## No Patent Or Trademark Grant
 
 These terms do not grant patent rights, trademark ownership, or rights to use
 the CoAkka name beyond truthful reference to the project, compatible
-integrations, and unmodified official Artifacts. Trademark use is governed by
-`TRADEMARKS.md`.
+integrations, and unmodified official Native Artifacts. Trademark use is
+governed by the CoAkka trademark guidance distributed with the applicable
+package or public documentation.
 
 ## Questions
 
 For questions about whether an offering is a Managed CoAkka Service or requires
-a separate agreement, use the contact path in `SUPPORT.md`.
+a separate agreement, use the public support path in the `coakka-samples`
+repository.
 
 ## Legal Notice
 

package/NOTICE

@@ -1,9 +1,16 @@
-CoAkka Connectors
+CoAkka Packages
 Copyright 2026 Phuong Tran and contributors.
 
-Language-level connector material is licensed under the Apache License,
-Version 2.0. Bundled CoAkka native artifacts remain under the CoAkka Public
-Artifact License 1.1. See PACKAGE-LICENSE.md for the file-scope map, LICENSE
-for Apache-2.0, and NATIVE-LICENSE.md for the native artifact terms.
+Connector source, generated bindings, type declarations, package metadata,
+examples, and package documentation are licensed under the Apache License,
+Version 2.0.
 
-Third-party components retain their respective copyright and license notices.
+Bundled CoAkka native libraries or executables, native headers, symbol files,
+and native-only provenance are licensed under the CoAkka Native Artifact
+License 1.2.
+
+See PACKAGE-LICENSE.md for the file-scope map, LICENSE for Apache-2.0, and
+NATIVE-LICENSE.md for the native terms. CoAkka packages are free to use in
+applications, including commercial and production applications. Selling or
+offering CoAkka itself as managed runtime or infrastructure requires a separate
+agreement under the native terms.

package/PACKAGE-LICENSE.md

@@ -1,29 +1,31 @@
-# CoAkka Connector Package Licensing
+# CoAkka Package License Map
 
-This distribution is a multi-license aggregate. Its licenses apply by file scope;
-they are not alternative licenses for the complete package.
+This package is free to use in applications, including commercial and
+production applications. Its licenses apply by file scope; they apply
+simultaneously to their respective files and are not alternative licenses for
+the package as a whole.
 
 ## Connector Material: Apache-2.0
 
-Language-level connector source, generated language bindings, type declarations,
-package/build metadata, examples, and package documentation are licensed under
-the Apache License, Version 2.0. The full terms are in `LICENSE`.
+Language-level connector source, generated bindings, type declarations,
+package metadata, examples, and package documentation are licensed under the
+Apache License, Version 2.0. The full terms are in `LICENSE`.
 
-## CoAkka Native Material
+## Native Material: CoAkka Native Artifact License 1.2
 
-CoAkka native shared or static libraries, native C headers, symbol files, and
-native-only provenance records are licensed under the CoAkka Public Artifact
-License 1.1. The full terms are in `NATIVE-LICENSE.md`.
+Compiled CoAkka native libraries or executables, native headers, native symbol
+files, and native-only provenance are licensed under the CoAkka Native Artifact
+License 1.2. The full terms are in `NATIVE-LICENSE.md`.
 
-This scope includes CoAkka payloads below `native/`, `runtimes/*/native/`,
-`META-INF/native/`, or another package-specific native payload directory, plus
-files explicitly identified as CoAkka native artifacts. Copying or extracting a
-native payload does not change its license.
+The Native Artifact License permits ordinary internal, production, commercial,
+application, and SaaS use. A separate agreement is required to sell or offer
+CoAkka itself as a managed runtime, control plane, appliance, cloud image, or
+substantially equivalent infrastructure service.
 
-## Third-Party Material
+## Aggregate Notice
 
-Third-party or vendored components retain their own license terms. Their notices
-are included with those components or in the package's third-party notices.
+`NOTICE` records the package identity and summarizes this file-scoped mapping.
+It does not replace either license.
 
-If a file contains an explicit license notice, that notice controls for that
-file. Otherwise, use the scope above.
+Public guidance and stable links are available in the
+[CoAkka package licensing guide](https://github.com/phuong-tran/coakka-samples/blob/main/docs/package-licensing.md).

package/README.md

@@ -147,10 +147,14 @@ preload/renderer IPC. See the shared [file-lane contract](https://github.com/phu
 
 ## Stream Lane
 
-Version `2.5.0` contains the Stream Lane connector surface for Electron main
+Version `2.5.2` contains owner-aware File and Stream Lane connector surfaces for Electron main
 over exact native generation `2.5.0+4b65d0b2256037bf7fc180bfa6df8c41efc1dd6a`. Keep runtime ownership in the
 main process and follow the public
 [streaming contract](https://github.com/phuong-tran/coakka-samples/blob/main/docs/runtime-streaming.md).
+Electron re-exports Node's `FileReceiveGrant`, `StreamPublishGrant`, and
+`openOwned`/`prepare*Grant` methods only to main-process code. Follow the
+[owner-grant ONE/ALL sample](https://github.com/phuong-tran/coakka-samples/blob/main/docs/runtime-lane-owner-grants.md)
+and keep serialized grants out of preload and renderer IPC.
 
 ## AI-Assisted Integration
 
@@ -159,9 +163,18 @@ Before generating Electron integration code, read the public
 and the runnable Electron sample. Connection policy and native lane ownership
 belong to Electron main; renderer code sends validated intent only.
 
+
 ## License
 
-Connector material is Apache-2.0 under [LICENSE](LICENSE). Bundled native
-material uses the terms in [NATIVE-LICENSE.md](NATIVE-LICENSE.md). See
-[PACKAGE-LICENSE.md](PACKAGE-LICENSE.md) for the file-scope map and
-[NOTICE](NOTICE) for the package notice.
+**Free for application use, including commercial and production use.**
+
+Connector source, generated bindings, type declarations, examples, and package
+documentation use the [Apache License, Version 2.0](https://github.com/phuong-tran/coakka-samples/blob/main/LICENSE).
+Bundled Native Core files use the [CoAkka Native Artifact License 1.2](https://github.com/phuong-tran/coakka-samples/blob/main/NATIVE-LICENSE.md).
+Those native terms permit ordinary application and SaaS use but require a
+separate agreement to sell or offer CoAkka itself as managed runtime or
+infrastructure.
+
+See [CoAkka Package Licensing](https://github.com/phuong-tran/coakka-samples/blob/main/docs/package-licensing.md)
+for the file-scope map. The package also carries offline `LICENSE`,
+`NATIVE-LICENSE.md`, `PACKAGE-LICENSE.md`, and `NOTICE` copies.

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import { type RuntimeCapabilitiesSnapshot, type RuntimeTcpConnectionApplyResult, type RuntimeTcpConnectionConfigSnapshot, type RuntimeTcpConnectionStrategySpec, type RuntimeTcpSecurityApplyResult, type RuntimeTcpSecurityInfoSnapshot, type RuntimeTcpSecuritySpec } from "coakka-v2-connector-node";
 export { RuntimeCapability, RuntimeTcpConnectionMode, RuntimeTcpSecurityMode, RuntimeTlsReloadMode, supportsRuntimeCapabilities, } from "coakka-v2-connector-node";
 /**
- * Stream Lane is available only to trusted Electron main-process code. It is
- * intentionally absent from the preload and renderer intent surfaces.
+ * File and Stream Lanes are available only to trusted Electron main-process
+ * code. They are intentionally absent from preload and renderer intents so
+ * file paths and bearer grants never cross that boundary implicitly.
  */
-export { STREAM_LANE_DETAIL_MAX_BYTES, STREAM_LANE_MAX_FRAME_BYTES, STREAM_LANE_MAX_WINDOW_BYTES, StreamConsumerDecision, StreamDirection, StreamFrameFlag, StreamLane, StreamLaneError, StreamLaneFlag, StreamLaneSecurityMode, StreamPressureReason, StreamPressureState, StreamResult, StreamSourceSignal, StreamState, type StreamConsumer, type StreamFrameMetadata, type StreamLaneConfig, type StreamLaneSecurityConfig, type StreamLaneStats, type StreamPressureSnapshot, type StreamPublishSpec, type StreamSessionSnapshot, type StreamSource, type StreamSourceFrame, type StreamSubscribeSpec, } from "coakka-v2-connector-node";
-export declare const COAKKA_ELECTRON_CONNECTOR_VERSION = "2.5.0";
+export { FILE_LANE_DETAIL_MAX_BYTES, FILE_LANE_SHA256_BYTES, LANE_OWNER_GRANTS_FEATURE, FileLane, FileLaneError, FileLaneFlag, FileLaneSecurityMode, FileReceiveGrant, FileTransferDirection, FileTransferResult, FileTransferState, LaneOwnerGrantUnavailableError, STREAM_LANE_DETAIL_MAX_BYTES, STREAM_LANE_MAX_FRAME_BYTES, STREAM_LANE_MAX_WINDOW_BYTES, StreamConsumerDecision, StreamDirection, StreamFrameFlag, StreamLane, StreamLaneError, StreamLaneFlag, StreamLaneSecurityMode, StreamPublishGrant, StreamPressureReason, StreamPressureState, StreamResult, StreamSourceSignal, StreamState, type FileDigest, type FileLaneConfig, type FileLaneSecurityConfig, type FileLaneStats, type FileReceiveSpec, type FileSendSpec, type FileTransferSnapshot, type LaneOwnerConfig, type LaneOwnerEndpoint, type StreamConsumer, type StreamFrameMetadata, type StreamLaneConfig, type StreamLaneSecurityConfig, type StreamLaneStats, type StreamPressureSnapshot, type StreamPublishSpec, type StreamSessionSnapshot, type StreamSource, type StreamSourceFrame, type StreamSubscribeSpec, } from "coakka-v2-connector-node";
+export declare const COAKKA_ELECTRON_CONNECTOR_VERSION = "2.5.2";
 export declare const COAKKA_ELECTRON_INTENT_CHANNEL = "coakka:intent";
 export interface ElectronIntentPayloadIdentity {
     messageType: string;

package/dist/index.js

@@ -1,11 +1,12 @@
 import { DeliveryHint, EndpointFlag, NodeRuntimeClient, PayloadFormat, PayloadIdentity, RuntimeHost, } from "coakka-v2-connector-node";
 export { RuntimeCapability, RuntimeTcpConnectionMode, RuntimeTcpSecurityMode, RuntimeTlsReloadMode, supportsRuntimeCapabilities, } from "coakka-v2-connector-node";
 /**
- * Stream Lane is available only to trusted Electron main-process code. It is
- * intentionally absent from the preload and renderer intent surfaces.
+ * File and Stream Lanes are available only to trusted Electron main-process
+ * code. They are intentionally absent from preload and renderer intents so
+ * file paths and bearer grants never cross that boundary implicitly.
  */
-export { STREAM_LANE_DETAIL_MAX_BYTES, STREAM_LANE_MAX_FRAME_BYTES, STREAM_LANE_MAX_WINDOW_BYTES, StreamConsumerDecision, StreamDirection, StreamFrameFlag, StreamLane, StreamLaneError, StreamLaneFlag, StreamLaneSecurityMode, StreamPressureReason, StreamPressureState, StreamResult, StreamSourceSignal, StreamState, } from "coakka-v2-connector-node";
-export const COAKKA_ELECTRON_CONNECTOR_VERSION = "2.5.0";
+export { FILE_LANE_DETAIL_MAX_BYTES, FILE_LANE_SHA256_BYTES, LANE_OWNER_GRANTS_FEATURE, FileLane, FileLaneError, FileLaneFlag, FileLaneSecurityMode, FileReceiveGrant, FileTransferDirection, FileTransferResult, FileTransferState, LaneOwnerGrantUnavailableError, STREAM_LANE_DETAIL_MAX_BYTES, STREAM_LANE_MAX_FRAME_BYTES, STREAM_LANE_MAX_WINDOW_BYTES, StreamConsumerDecision, StreamDirection, StreamFrameFlag, StreamLane, StreamLaneError, StreamLaneFlag, StreamLaneSecurityMode, StreamPublishGrant, StreamPressureReason, StreamPressureState, StreamResult, StreamSourceSignal, StreamState, } from "coakka-v2-connector-node";
+export const COAKKA_ELECTRON_CONNECTOR_VERSION = "2.5.2";
 export const COAKKA_ELECTRON_INTENT_CHANNEL = "coakka:intent";
 const DEFAULT_ROUTE_PORT = 19481;
 export class ElectronRuntimeIntentBridge {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coakka-v2-connector-electron",
-  "version": "2.5.0",
+  "version": "2.5.2",
   "description": "Electron connector for the polyglot, multi-language, multi-platform CoAkka Runtime ecosystem",
   "license": "SEE LICENSE IN PACKAGE-LICENSE.md",
   "repository": {
@@ -55,7 +55,7 @@
     "smoke:packaged": "bash scripts/smoke-packaged-package.sh"
   },
   "dependencies": {
-    "coakka-v2-connector-node": "2.5.0"
+    "coakka-v2-connector-node": "2.5.2"
   },
   "peerDependencies": {
     "electron": ">=42"