@lunora/do 1.0.0-alpha.16 → 1.0.0-alpha.161

package/LICENSE.md

@@ -103,3 +103,9 @@ Unless required by applicable law or agreed to in writing, software distributed
 under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+<!-- DEPENDENCIES -->
+<!-- /DEPENDENCIES -->
+
+<!-- TYPE_DEPENDENCIES -->
+<!-- /TYPE_DEPENDENCIES -->

package/README.md

@@ -78,6 +78,17 @@ export class MyShard extends ShardDO {
 }
 ```
 
+`broadcastDelta` is the raw-delta fan-out for a shard like this one, which has
+no `executeSubscription` override and so cannot re-run a subscriber's query. It
+delivers to sockets whose registered subscription carries a `table` string equal
+to `delta.table` — an exact match, with no table-dependency analysis behind it.
+`@lunora/client` has no table name to register there and sends the function path
+instead, and so does every non-JS SDK — their `subscribe` methods do not expose
+the field at all. So no client shipped here reaches a delta stamped with a real
+table name; addressing one means building the subscribe frame by hand. Projects
+generated by `lunora codegen` route this hook to `recordChangedTable` and get
+server-side re-execution instead, which is the path to prefer.
+
 > This README covers the basics. For the full API, options, and guides, see the **[documentation](https://lunora.sh/docs/api/do)**.
 
 ## Related