@misofm/platform 0.21.1 → 0.22.1

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export * from "./release-graph.ts";
 export * from "./publication.ts";
 export * from "./catalog.ts";
 export * from "./walrus-ids.ts";
+export * from "./streaming.ts";
+export * from "./walrus.ts";
 export * as read from "./read/index.ts";
 export * from "./credits.ts";
 export * from "./cover.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,gCAAgC,EAChC,uBAAuB,EACvB,UAAU,EACV,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAKhC,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAIxC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAG3B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,gCAAgC,EAChC,uBAAuB,EACvB,UAAU,EACV,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,4BAA4B,EAC5B,WAAW,EACX,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAK5B,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAIxC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAG3B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -35,6 +35,8 @@ export * from "./release-graph.js";
 export * from "./publication.js";
 export * from "./catalog.js";
 export * from "./walrus-ids.js";
+export * from "./streaming.js";
+export * from "./walrus.js";
 // High-level, JSON-safe platform projections used directly by clients and by
 // the thin HTTP read service. Namespaced because these composed view types are
 // intentionally distinct from the lower-level contract views above.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,2CAA2C;AAC3C,EAAE;AACF,6EAA6E;AAC7E,kEAAkE;AAClE,EAAE;AACF,iFAAiF;AACjF,sFAAsF;AACtF,gFAAgF;AAChF,8EAA8E;AAC9E,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,yEAAyE;AACzE,2DAA2D;AAC3D,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF,kFAAkF;AAClF,2EAA2E;AAC3E,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,gCAAgC,EAChC,uBAAuB,EACvB,UAAU,EACV,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAMrB,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAEhC,6EAA6E;AAC7E,+EAA+E;AAC/E,oEAAoE;AACpE,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,yEAAyE;AACzE,kBAAkB;AAClB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAE3B,sEAAsE;AACtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC,2CAA2C;AAC3C,EAAE;AACF,6EAA6E;AAC7E,kEAAkE;AAClE,EAAE;AACF,iFAAiF;AACjF,sFAAsF;AACtF,gFAAgF;AAChF,8EAA8E;AAC9E,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,yEAAyE;AACzE,2DAA2D;AAC3D,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAEhF,kFAAkF;AAClF,2EAA2E;AAC3E,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,gCAAgC,EAChC,uBAAuB,EACvB,UAAU,EACV,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAMrB,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAE5B,6EAA6E;AAC7E,+EAA+E;AAC/E,oEAAoE;AACpE,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,yEAAyE;AACzE,kBAAkB;AAClB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAE3B,sEAAsE;AACtE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC"}

package/dist/streaming.d.ts

@@ -0,0 +1,5 @@
+import { type WalrusNetwork } from "./walrus.ts";
+export * from "@misofm/streaming";
+/** The master playlist URL for a track's transcode Quilt on a network's aggregator. */
+export declare function streamUrl(network: WalrusNetwork, quiltId: string): string;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AASA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtE,cAAc,mBAAmB,CAAC;AAElC,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/streaming.js

@@ -0,0 +1,14 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Streaming transcodes as the platform sees them: the `miso-hls/v1` contract
+ * from `@misofm/streaming`, plus where a client reads a track's items from.
+ */
+import { MASTER_PLAYLIST, quiltItemUrl } from "@misofm/streaming";
+import { walrusAggregatorUrl } from "./walrus.js";
+export * from "@misofm/streaming";
+/** The master playlist URL for a track's transcode Quilt on a network's aggregator. */
+export function streamUrl(network, quiltId) {
+    return quiltItemUrl(walrusAggregatorUrl(network), quiltId, MASTER_PLAYLIST);
+}
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AAEtE,cAAc,mBAAmB,CAAC;AAElC,uFAAuF;AACvF,MAAM,UAAU,SAAS,CAAC,OAAsB,EAAE,OAAe;IAC/D,OAAO,YAAY,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;AAC9E,CAAC"}

package/dist/walrus.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Walrus facts the platform depends on that no contract module should know:
+ * the shard configuration ids are derived against, how long Miso stores
+ * published blobs, and where clients read them from.
+ */
+/**
+ * Shard count of the Walrus committees Miso publishes to. Blob and Quilt ids
+ * depend on it, so `put` and `prepare` derive ids against this constant
+ * offline, and `store` must assert the live committee still reports it
+ * before uploading. Testnet and mainnet both run 1000 shards.
+ */
+export declare const WALRUS_N_SHARDS = 1000;
+/**
+ * Initial storage duration for every blob Miso publishes. A mainnet Walrus
+ * epoch is two weeks, so four epochs is eight weeks; blobs are shared and
+ * permanent, so anyone can extend them. Not a release.json field: publication
+ * policy is the platform's, not the release owner's.
+ */
+export declare const WALRUS_STORAGE_EPOCHS = 4;
+/**
+ * Published blobs are permanent (not deletable) and wrapped as shared blob
+ * objects, so anyone, not only the publisher, can fund an extension when the
+ * storage period nears its end.
+ */
+export declare const WALRUS_BLOBS_DELETABLE = false;
+export declare const WALRUS_BLOBS_SHARED = true;
+export type WalrusNetwork = "testnet" | "mainnet";
+/**
+ * Where clients read published blobs and Quilt items. A Miso CDN
+ * (`cdn.miso.fm`) will front this later; the URL shape stays the same.
+ */
+export declare function walrusAggregatorUrl(network: WalrusNetwork): string;
+/**
+ * Miso's private Walrus publisher for a network, the storage counterpart of
+ * the Onara gas sponsors. Reachable only from the Fly organization network
+ * (WireGuard or a machine inside it); it pays SUI and WAL from its own wallet.
+ */
+export declare function walrusPublisherUrl(network: WalrusNetwork): string;
+/** Query string every Miso upload sends to the publisher: permanent, shared, four epochs. */
+export declare function walrusPublishQuery(): string;
+//# sourceMappingURL=walrus.d.ts.map

package/dist/walrus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walrus.d.ts","sourceRoot":"","sources":["../src/walrus.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAC5C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAElD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAEjE;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/walrus.js

@@ -0,0 +1,48 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Walrus facts the platform depends on that no contract module should know:
+ * the shard configuration ids are derived against, how long Miso stores
+ * published blobs, and where clients read them from.
+ */
+/**
+ * Shard count of the Walrus committees Miso publishes to. Blob and Quilt ids
+ * depend on it, so `put` and `prepare` derive ids against this constant
+ * offline, and `store` must assert the live committee still reports it
+ * before uploading. Testnet and mainnet both run 1000 shards.
+ */
+export const WALRUS_N_SHARDS = 1000;
+/**
+ * Initial storage duration for every blob Miso publishes. A mainnet Walrus
+ * epoch is two weeks, so four epochs is eight weeks; blobs are shared and
+ * permanent, so anyone can extend them. Not a release.json field: publication
+ * policy is the platform's, not the release owner's.
+ */
+export const WALRUS_STORAGE_EPOCHS = 4;
+/**
+ * Published blobs are permanent (not deletable) and wrapped as shared blob
+ * objects, so anyone, not only the publisher, can fund an extension when the
+ * storage period nears its end.
+ */
+export const WALRUS_BLOBS_DELETABLE = false;
+export const WALRUS_BLOBS_SHARED = true;
+/**
+ * Where clients read published blobs and Quilt items. A Miso CDN
+ * (`cdn.miso.fm`) will front this later; the URL shape stays the same.
+ */
+export function walrusAggregatorUrl(network) {
+    return `https://aggregator.${network}.walrus.mirai.cloud`;
+}
+/**
+ * Miso's private Walrus publisher for a network, the storage counterpart of
+ * the Onara gas sponsors. Reachable only from the Fly organization network
+ * (WireGuard or a machine inside it); it pays SUI and WAL from its own wallet.
+ */
+export function walrusPublisherUrl(network) {
+    return `http://walrus-publisher-${network}.flycast`;
+}
+/** Query string every Miso upload sends to the publisher: permanent, shared, four epochs. */
+export function walrusPublishQuery() {
+    return `epochs=${WALRUS_STORAGE_EPOCHS}&permanent=true&share=true`;
+}
+//# sourceMappingURL=walrus.js.map

package/dist/walrus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walrus.js","sourceRoot":"","sources":["../src/walrus.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,sCAAsC;AAEtC;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAIxC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,OAAO,sBAAsB,OAAO,qBAAqB,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAsB;IACvD,OAAO,2BAA2B,OAAO,UAAU,CAAC;AACtD,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB;IAChC,OAAO,UAAU,qBAAqB,4BAA4B,CAAC;AACrE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misofm/platform",
-  "version": "0.21.1",
+  "version": "0.22.1",
   "packageManager": "bun@1.4.0",
   "description": "Complete client SDK for the Miso platform on Sui \u2014 high-level reads, pressings, listings, records, and work publishing.",
   "license": "Apache-2.0",
@@ -89,6 +89,14 @@
       "types": "./dist/recording-extensions.d.ts",
       "default": "./dist/recording-extensions.js"
     },
+    "./streaming": {
+      "types": "./dist/streaming.d.ts",
+      "default": "./dist/streaming.js"
+    },
+    "./walrus": {
+      "types": "./dist/walrus.d.ts",
+      "default": "./dist/walrus.js"
+    },
     "./read": {
       "types": "./dist/read/index.d.ts",
       "default": "./dist/read/index.js"
@@ -125,7 +133,8 @@
     "prepare": "rm -rf dist && tsc -p tsconfig.build.json --noCheck"
   },
   "dependencies": {
-    "@misofm/protocol": "0.15.0",
+    "@misofm/streaming": "0.1.0",
+    "@misofm/protocol": "0.16.0",
     "@mysten/bcs": "^2.1.1"
   },
   "devDependencies": {

package/src/index.ts

@@ -50,6 +50,8 @@ export * from "./release-graph.ts";
 export * from "./publication.ts";
 export * from "./catalog.ts";
 export * from "./walrus-ids.ts";
+export * from "./streaming.ts";
+export * from "./walrus.ts";
 
 // High-level, JSON-safe platform projections used directly by clients and by
 // the thin HTTP read service. Namespaced because these composed view types are

package/src/streaming.ts

@@ -0,0 +1,17 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Streaming transcodes as the platform sees them: the `miso-hls/v1` contract
+ * from `@misofm/streaming`, plus where a client reads a track's items from.
+ */
+
+import { MASTER_PLAYLIST, quiltItemUrl } from "@misofm/streaming";
+import { walrusAggregatorUrl, type WalrusNetwork } from "./walrus.ts";
+
+export * from "@misofm/streaming";
+
+/** The master playlist URL for a track's transcode Quilt on a network's aggregator. */
+export function streamUrl(network: WalrusNetwork, quiltId: string): string {
+  return quiltItemUrl(walrusAggregatorUrl(network), quiltId, MASTER_PLAYLIST);
+}

package/src/walrus.ts

@@ -0,0 +1,56 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Walrus facts the platform depends on that no contract module should know:
+ * the shard configuration ids are derived against, how long Miso stores
+ * published blobs, and where clients read them from.
+ */
+
+/**
+ * Shard count of the Walrus committees Miso publishes to. Blob and Quilt ids
+ * depend on it, so `put` and `prepare` derive ids against this constant
+ * offline, and `store` must assert the live committee still reports it
+ * before uploading. Testnet and mainnet both run 1000 shards.
+ */
+export const WALRUS_N_SHARDS = 1000;
+
+/**
+ * Initial storage duration for every blob Miso publishes. A mainnet Walrus
+ * epoch is two weeks, so four epochs is eight weeks; blobs are shared and
+ * permanent, so anyone can extend them. Not a release.json field: publication
+ * policy is the platform's, not the release owner's.
+ */
+export const WALRUS_STORAGE_EPOCHS = 4;
+
+/**
+ * Published blobs are permanent (not deletable) and wrapped as shared blob
+ * objects, so anyone, not only the publisher, can fund an extension when the
+ * storage period nears its end.
+ */
+export const WALRUS_BLOBS_DELETABLE = false;
+export const WALRUS_BLOBS_SHARED = true;
+
+export type WalrusNetwork = "testnet" | "mainnet";
+
+/**
+ * Where clients read published blobs and Quilt items. A Miso CDN
+ * (`cdn.miso.fm`) will front this later; the URL shape stays the same.
+ */
+export function walrusAggregatorUrl(network: WalrusNetwork): string {
+  return `https://aggregator.${network}.walrus.mirai.cloud`;
+}
+
+/**
+ * Miso's private Walrus publisher for a network, the storage counterpart of
+ * the Onara gas sponsors. Reachable only from the Fly organization network
+ * (WireGuard or a machine inside it); it pays SUI and WAL from its own wallet.
+ */
+export function walrusPublisherUrl(network: WalrusNetwork): string {
+  return `http://walrus-publisher-${network}.flycast`;
+}
+
+/** Query string every Miso upload sends to the publisher: permanent, shared, four epochs. */
+export function walrusPublishQuery(): string {
+  return `epochs=${WALRUS_STORAGE_EPOCHS}&permanent=true&share=true`;
+}