@camstack/addon-pipeline-orchestrator 0.1.13 → 0.1.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.mjs CHANGED
@@ -10292,51 +10292,6 @@ const AuthResultSchema = object({
10292
10292
  validateToken: method(object({ token: string() }), AuthResultSchema.nullable())
10293
10293
  }
10294
10294
  });
10295
- const AuthProviderInfoSchema = object({
10296
- /** Stable id matching the addon id (used for `getLoginUrl({addonId,…})`). */
10297
- addonId: string(),
10298
- /**
10299
- * Per-instance id when one addon registers multiple "logical"
10300
- * providers (e.g. OIDC with Google + Microsoft + custom). The login
10301
- * URL becomes `/addon/${addonId}/${instanceId}/start` — handler reads
10302
- * `:instanceId` from the route. Empty/unset means the addon is a
10303
- * single-instance provider; the URL is `/addon/${addonId}/start`.
10304
- */
10305
- instanceId: string().optional(),
10306
- /** Display label shown on the login button + admin row. */
10307
- displayName: string(),
10308
- /** Optional iconography hint (lucide-react icon name OR emoji). */
10309
- icon: string().optional(),
10310
- /** When true, the provider exposes a redirect-based login flow
10311
- * (`getLoginUrl` returns a URL the browser navigates to). */
10312
- hasRedirectFlow: boolean(),
10313
- /** When true, the provider exposes a credential-form login flow
10314
- * (`validateCredentials` accepts username + password). */
10315
- hasCredentialFlow: boolean(),
10316
- /** Provider kind, drives admin-UI hint dispatch (oidc / saml / totp / …). */
10317
- kind: string().optional(),
10318
- /** Operator-facing status string (e.g. "Connected to https://login.acme.com"). */
10319
- status: string().optional(),
10320
- /** When false, the provider is registered but disabled by config; the
10321
- * UI surfaces it as inactive without enumerating it for login. */
10322
- enabled: boolean()
10323
- });
10324
- ({
10325
- methods: {
10326
- /** All registered auth providers, both enabled and disabled. */
10327
- listProviders: method(_void(), array(AuthProviderInfoSchema).readonly()),
10328
- /**
10329
- * Toggle a provider's enabled flag. Disabled providers stay
10330
- * registered but aren't surfaced on the login page. The orchestrator
10331
- * persists the state in `addon-settings` so it survives restarts.
10332
- */
10333
- setProviderEnabled: method(
10334
- object({ addonId: string(), enabled: boolean() }),
10335
- object({ success: literal(true) }),
10336
- { kind: "mutation", auth: "admin" }
10337
- )
10338
- }
10339
- });
10340
10295
  const NetworkEndpointSchema = object({
10341
10296
  url: string(),
10342
10297
  hostname: string(),
@@ -10368,55 +10323,13 @@ const NetworkEndpointEntrySchema = NetworkEndpointSchema.extend({
10368
10323
  getEndpoint: method(_void(), NetworkEndpointSchema.nullable()),
10369
10324
  getStatus: method(_void(), NetworkAccessStatusSchema),
10370
10325
  /**
10371
- * Enumerate every active ingress entry. Default implementation (when
10372
- * the provider omits this method) is derived from `getEndpoint()` —
10373
- * see the remote-access orchestrator for the fallback path.
10326
+ * Enumerate every active ingress entry. Providers that expose only a
10327
+ * single endpoint may omit this method; callers fall back to
10328
+ * `getEndpoint()` in that case.
10374
10329
  */
10375
10330
  listEndpoints: method(_void(), array(NetworkEndpointEntrySchema).readonly())
10376
10331
  }
10377
10332
  });
10378
- const RemoteAccessEndpointSchema = object({
10379
- url: string(),
10380
- hostname: string(),
10381
- port: number(),
10382
- protocol: _enum(["http", "https"])
10383
- });
10384
- const RemoteAccessProviderInfoSchema = object({
10385
- /** Stable id matching the addon id. */
10386
- addonId: string(),
10387
- /** Display label shown on the admin row — sourced from the addon manifest. */
10388
- displayName: string(),
10389
- /** When false, the provider is registered but disabled. */
10390
- enabled: boolean(),
10391
- /** True when the underlying tunnel/connection is up. */
10392
- connected: boolean(),
10393
- /** Public-facing endpoint, when connected. Null otherwise. */
10394
- endpoint: RemoteAccessEndpointSchema.nullable(),
10395
- /** Last error message (when connected=false), if available. */
10396
- error: string().optional()
10397
- });
10398
- ({
10399
- methods: {
10400
- /** All registered remote-access providers + their live status. */
10401
- listProviders: method(_void(), array(RemoteAccessProviderInfoSchema).readonly()),
10402
- /**
10403
- * Start a specific provider's tunnel. Per-provider config still
10404
- * lives on the addon's settings panel; this is just the on/off
10405
- * trigger so the admin UI can manage the lifecycle from one place.
10406
- */
10407
- startProvider: method(
10408
- object({ addonId: string() }),
10409
- RemoteAccessEndpointSchema,
10410
- { kind: "mutation", auth: "admin" }
10411
- ),
10412
- /** Stop a specific provider's tunnel (idempotent on already-stopped). */
10413
- stopProvider: method(
10414
- object({ addonId: string() }),
10415
- object({ success: literal(true) }),
10416
- { kind: "mutation", auth: "admin" }
10417
- )
10418
- }
10419
- });
10420
10333
  const TurnServerSchema = object({
10421
10334
  /** Single URL or list of URLs (e.g. "turn:turn.example.com:3478?transport=udp"). */
10422
10335
  urls: union([string(), array(string())]),
@@ -10436,45 +10349,6 @@ const TurnServerSchema = object({
10436
10349
  )
10437
10350
  }
10438
10351
  });
10439
- const TurnProviderInfoSchema = object({
10440
- /** Stable id matching the addon id. */
10441
- addonId: string(),
10442
- /** Display label shown on the admin row — sourced from the addon manifest. */
10443
- displayName: string(),
10444
- /** When false, the provider is registered but disabled. */
10445
- enabled: boolean(),
10446
- /** Number of servers this provider is currently exposing. */
10447
- serverCount: number(),
10448
- /**
10449
- * Flat list of every TURN/STUN URL this provider currently exposes.
10450
- * One row per URL (multi-URL ICE server entries are flattened). The
10451
- * admin UI shows this in a compact per-provider list so operators
10452
- * can verify what's actually being negotiated without having to dig
10453
- * into the combined `getAllServers` output.
10454
- */
10455
- urls: array(string()).readonly(),
10456
- /** Last fetch error (when serverCount=0 due to API failure), if any. */
10457
- error: string().optional()
10458
- });
10459
- ({
10460
- methods: {
10461
- /** All registered TURN providers + per-provider stats. */
10462
- listProviders: method(_void(), array(TurnProviderInfoSchema).readonly()),
10463
- /**
10464
- * Combined list of TURN/STUN servers from all ENABLED providers.
10465
- * Consumed by the WebRTC layer at session-creation time —
10466
- * implementations may fetch fresh short-lived credentials each
10467
- * call (e.g. Cloudflare API), so consumers SHOULD call per-session.
10468
- */
10469
- getAllServers: method(_void(), array(TurnServerSchema).readonly()),
10470
- /** Toggle a provider's enabled flag. */
10471
- setProviderEnabled: method(
10472
- object({ addonId: string(), enabled: boolean() }),
10473
- object({ success: literal(true) }),
10474
- { kind: "mutation", auth: "admin" }
10475
- )
10476
- }
10477
- });
10478
10352
  const SnapshotImageSchema = object({
10479
10353
  base64: string(),
10480
10354
  contentType: string()
@@ -11942,7 +11816,7 @@ const AllowedAddressesSchema = object({
11942
11816
  )
11943
11817
  }
11944
11818
  });
11945
- const MeshEndpointSchema$1 = object({
11819
+ const MeshEndpointSchema = object({
11946
11820
  /** Stable identifier within the provider (e.g. `mesh-ipv4`, `magicdns`, `funnel`). */
11947
11821
  id: string(),
11948
11822
  /** Operator-facing label (e.g. "Mesh IPv4", "MagicDNS"). */
@@ -12015,7 +11889,7 @@ const MeshStatusSchema = object({
12015
11889
  /** Number of peers visible to this host (excluding self). */
12016
11890
  peerCount: number(),
12017
11891
  /** Every endpoint this provider exposes for the current host. */
12018
- endpoints: array(MeshEndpointSchema$1).readonly(),
11892
+ endpoints: array(MeshEndpointSchema).readonly(),
12019
11893
  /** Last error from the daemon, when not joined. */
12020
11894
  error: string().optional(),
12021
11895
  // ── Account / tenant identity (generic across providers) ────────
@@ -12178,105 +12052,6 @@ const MeshStatusSchema = object({
12178
12052
  // tabs driven by this cap.
12179
12053
  }
12180
12054
  });
12181
- const MeshEndpointSchema = object({
12182
- id: string(),
12183
- label: string(),
12184
- scope: _enum(["mesh", "public"]),
12185
- url: string(),
12186
- hostname: string(),
12187
- port: number(),
12188
- protocol: _enum(["http", "https"])
12189
- });
12190
- const MeshProviderInfoSchema = object({
12191
- /** Stable id matching the addon id. */
12192
- addonId: string(),
12193
- /** Display label shown on the admin row — sourced from the addon manifest. */
12194
- displayName: string(),
12195
- /** True when the host is joined to this provider's mesh. */
12196
- joined: boolean(),
12197
- /** Local mesh IP (empty when not joined). */
12198
- meshIp: string(),
12199
- /** MagicDNS / mesh hostname (empty when not configured). */
12200
- magicDnsHostname: string(),
12201
- /** Peer count (excluding self). */
12202
- peerCount: number(),
12203
- /** Active endpoints (mesh IP + MagicDNS + optional public Funnel). */
12204
- endpoints: array(MeshEndpointSchema).readonly(),
12205
- /** Last error reported by the provider. */
12206
- error: string().optional(),
12207
- // ── Generic identity fields mirrored from MeshStatus ─────────────
12208
- /** Tenant / tailnet / network display name. Empty pre-join. */
12209
- tenantName: string(),
12210
- /** Mesh DNS suffix (e.g. tailXXXX.ts.net). Empty when not configured. */
12211
- magicDnsSuffix: string(),
12212
- /** Authenticated user / account login. Null for token-only providers. */
12213
- userLogin: string().nullable(),
12214
- /** Provider control-plane URL. */
12215
- controlPlaneUrl: string(),
12216
- /** Machine-key expiry (epoch ms). Null when keys don't rotate. */
12217
- keyExpiry: number().nullable()
12218
- });
12219
- ({
12220
- methods: {
12221
- /** All registered mesh-network providers + live status. */
12222
- listProviders: method(_void(), array(MeshProviderInfoSchema).readonly()),
12223
- /**
12224
- * Join the mesh of a specific provider. Per-provider config still
12225
- * lives on its settings panel; the orchestrator forwards.
12226
- */
12227
- joinProvider: method(
12228
- object({
12229
- addonId: string(),
12230
- authKey: string().min(8),
12231
- hostname: string().optional()
12232
- }),
12233
- object({ joined: literal(true) }),
12234
- { kind: "mutation" }
12235
- ),
12236
- leaveProvider: method(
12237
- object({ addonId: string() }),
12238
- object({ success: literal(true) }),
12239
- { kind: "mutation" }
12240
- ),
12241
- /**
12242
- * Browser-redirect login flow. Forwards to the named provider's
12243
- * `mesh-network.startLogin` and returns the URL the daemon
12244
- * prints. UI opens it in a new tab, then polls `listProviders`
12245
- * for `joined: true`.
12246
- */
12247
- startLoginProvider: method(
12248
- object({
12249
- addonId: string(),
12250
- hostname: string().optional()
12251
- }),
12252
- object({ loginUrl: string() }),
12253
- { kind: "mutation" }
12254
- ),
12255
- /**
12256
- * Sign out of the provider's account entirely (`mesh-network.logout`).
12257
- * Distinct from `leaveProvider` which only takes the host off-mesh;
12258
- * `logoutProvider` wipes credentials so the next start requires a
12259
- * fresh login.
12260
- */
12261
- logoutProvider: method(
12262
- object({ addonId: string() }),
12263
- object({ loggedOut: literal(true) }),
12264
- { kind: "mutation" }
12265
- ),
12266
- /**
12267
- * Per-provider peer list. Forwards to `mesh-network.listPeers` on
12268
- * the addressed provider. Separate from `listProviders` because
12269
- * peer payloads can be large on a heavily-populated tailnet —
12270
- * fetch only when the operator opens the Peers tab.
12271
- */
12272
- listProviderPeers: method(
12273
- object({ addonId: string() }),
12274
- object({
12275
- peers: array(MeshPeerSchema).readonly()
12276
- })
12277
- )
12278
- }
12279
- });
12280
12055
  const MethodAccessSchema = _enum(["view", "create", "delete"]);
12281
12056
  const AllowedProviderSchema = union([literal("*"), array(string())]);
12282
12057
  const AllowedDevicesSchema = record(string(), union([literal("*"), array(string())]));
@@ -13146,6 +12921,29 @@ const CustomActionInputSchema = object({
13146
12921
  isActive: boolean()
13147
12922
  })).readonly()
13148
12923
  ),
12924
+ /**
12925
+ * Toggle a single collection-cap provider on/off. Generic write-side
12926
+ * counterpart of `listCapabilityProviders` — drives the per-provider
12927
+ * Enable/Disable affordance in admin pages (TURN servers, etc.)
12928
+ * without needing a bespoke orchestrator cap.
12929
+ *
12930
+ * Reaches the hub's `CapabilityRegistry` directly:
12931
+ * `enableCollectionProvider` / `disableCollectionProvider` flip the
12932
+ * registry-level `disabledProviders` set. `getCollectionEntries`
12933
+ * already filters disabled providers out, so a disabled provider
12934
+ * drops out of every collection aggregate immediately. Only valid
12935
+ * for `mode: 'collection'` caps — the registry no-ops + warns for
12936
+ * singletons.
12937
+ */
12938
+ setCapabilityProviderEnabled: method(
12939
+ object({
12940
+ capName: string().min(1),
12941
+ addonId: string().min(1),
12942
+ enabled: boolean()
12943
+ }),
12944
+ object({ success: literal(true) }),
12945
+ { kind: "mutation", auth: "admin" }
12946
+ ),
13149
12947
  /**
13150
12948
  * Live-update one of the framework packages marked
13151
12949
  * `camstack.system: true` (`@camstack/types|kernel|core|sdk|ui-library`).