@toa.io/extensions.configuration 1.0.0-alpha.274 → 1.0.0-alpha.276

package/ui/src/@/configuration/ui/intl/built.js

@@ -1,38 +0,0 @@
-// Auto-generated by i18n CLI - do not edit manually
-
-/** @type {Record<import('$lib/intl').Locale, import('./types').Dictionary>} */
-export const dictionaries = {
-  "en-US": {
-    "values": {
-      "empty": "No component declares configuration.",
-      "nomatch": "No results match the filter."
-    },
-    "value": {
-      "none": "This component has no configuration.",
-      "secret": "Secret",
-      "count": (count) => {
-      const forms = {"one":"{n} value","other":"{n} values"};
-      const locale = "en-US"; // This will be replaced by the build system
-      const pluralRules = new Intl.PluralRules(locale);
-      const rule = pluralRules.select(count);
-      const table = /** @type {Record<string, string>} */ (forms);
-
-      return (table[rule] ?? table.other).replace(/{n}/g, new Intl.NumberFormat(locale).format(count));
-    },
-      "title": "Configuration"
-    },
-    "create": {
-      "action": "Edit",
-      "title": "Edit configuration",
-      "editor": "Configuration",
-      "submit": "Update",
-      "cancel": "Cancel",
-      "malformed": "This is not valid YAML.",
-      "failed": "The configuration could not be created."
-    },
-    "space": {
-      "user": "Userspace",
-      "system": "System"
-    }
-  }
-};

package/ui/src/@/configuration/ui/intl/context.yaml

@@ -1,51 +0,0 @@
-context: Mount 'configuration' context
-inputs:
-  values:
-    empty:
-      input: No component declares configuration.
-      context: shown when the application has no configured components at all
-    nomatch:
-      input: No results match the filter.
-      context: shown when the filter leaves the list empty
-  value:
-    none:
-      input: This component has no configuration.
-      context: shown on a component's screen when the service holds no configuration for it
-    secret:
-      input: Secret
-      context: "stands in place of a value that is a secret and is never shown; a noun, capitalized as a label"
-    count:
-      input: value
-      context: how many top-level values a component's configuration holds, shown on its row in the list
-    title:
-      input: Configuration
-      context: heading over the component's current configuration
-  create:
-    action:
-      input: Edit
-      context: "button that opens the dialog for changing a component's configuration. A change is stored as a new immutable object, but the reader edits what is there, so the word is the reader's, not the service's"
-    title:
-      input: Edit configuration
-      context: title of that dialog
-    editor:
-      input: Configuration
-      context: accessible name of the text area holding the configuration as YAML
-    submit:
-      input: Update
-      context: button that sends the edited configuration
-    cancel:
-      input: Cancel
-      context: button that closes the dialog without creating anything
-    malformed:
-      input: This is not valid YAML.
-      context: shown under the editor when the text cannot be parsed
-    failed:
-      input: The configuration could not be created.
-      context: shown when the service refused the request
-  space:
-    user:
-      input: Userspace
-      context: heading over the components the application itself declares
-    system:
-      input: System
-      context: heading over the components the runtime provides, such as identity

package/ui/src/@/configuration/ui/intl/en-US.yaml

@@ -1,21 +0,0 @@
-values:
-  empty: No component declares configuration.
-  nomatch: No results match the filter.
-value:
-  none: This component has no configuration.
-  secret: Secret
-  count:
-    - one: "{n} value"
-      other: "{n} values"
-  title: Configuration
-create:
-  action: Edit
-  title: Edit configuration
-  editor: Configuration
-  submit: Update
-  cancel: Cancel
-  malformed: This is not valid YAML.
-  failed: The configuration could not be created.
-space:
-  user: Userspace
-  system: System

package/ui/src/@/configuration/ui/intl/index.ts

@@ -1,9 +0,0 @@
-import { derived } from 'svelte/store'
-import { locale } from '$lib/intl'
-import { dictionaries } from './built.js'
-import type { Dictionary } from './types'
-
-const dict = derived(locale, ($locale) => dictionaries[$locale])
-
-export { dict, dictionaries }
-export type { Dictionary }

package/ui/src/@/configuration/ui/intl/types.ts

@@ -1,31 +0,0 @@
-/**
- * Auto-generated TypeScript definitions for i18n dictionaries
- *
- * @author copilot
- */
-
-export type Dictionary = {
-      values: {
-        empty: string
-        nomatch: string
-      }
-      value: {
-        none: string
-        secret: string
-        count: (value: number) => string
-        title: string
-      }
-      create: {
-        action: string
-        title: string
-        editor: string
-        submit: string
-        cancel: string
-        malformed: string
-        failed: string
-      }
-      space: {
-        user: string
-        system: string
-      }
-    }

package/ui/src/@/configuration/ui/read.test.ts

@@ -1,75 +0,0 @@
-import { it, expect } from 'vitest'
-import { holds, read } from './read'
-
-it('should read scalars', () => {
-  expect(read({ foo: 'hello', num: 0, on: true, none: null })).toEqual([
-    { depth: 0, key: 'foo', value: 'hello', secret: false },
-    { depth: 0, key: 'num', value: '0', secret: false },
-    { depth: 0, key: 'on', value: 'true', secret: false },
-    { depth: 0, key: 'none', value: 'null', secret: false },
-  ])
-})
-
-it('should open an object onto its properties', () => {
-  expect(read({ nested: { foo: 'bar' } })).toEqual([
-    { depth: 0, key: 'nested', value: null, secret: false },
-    { depth: 1, key: 'foo', value: 'bar', secret: false },
-  ])
-})
-
-it('should mark a list item', () => {
-  expect(read({ list: ['one', 'two'] })).toEqual([
-    { depth: 0, key: 'list', value: null, secret: false },
-    { depth: 1, key: '-', value: 'one', secret: false },
-    { depth: 1, key: '-', value: 'two', secret: false },
-  ])
-})
-
-it('should open a list of objects', () => {
-  expect(read({ greetings: [{ text: 'hello', times: 2 }] })).toEqual([
-    { depth: 0, key: 'greetings', value: null, secret: false },
-    { depth: 1, key: '-', value: null, secret: false },
-    { depth: 2, key: 'text', value: 'hello', secret: false },
-    { depth: 2, key: 'times', value: '2', secret: false },
-  ])
-})
-
-it('should write an empty object or list rather than open it', () => {
-  expect(read({ nothing: {}, none: [] })).toEqual([
-    { depth: 0, key: 'nothing', value: '{}', secret: false },
-    { depth: 0, key: 'none', value: '[]', secret: false },
-  ])
-})
-
-it('should never show a secret', () => {
-  expect(read({ apiKey: '$STRIPE_API_KEY' })).toEqual([
-    { depth: 0, key: 'apiKey', value: null, secret: true },
-  ])
-})
-
-it('should read a secret nested in a list', () => {
-  expect(read({ keys: [{ key: '$KEY0' }] })).toEqual([
-    { depth: 0, key: 'keys', value: null, secret: false },
-    { depth: 1, key: '-', value: null, secret: false },
-    { depth: 2, key: 'key', value: null, secret: true },
-  ])
-})
-
-it('should take a reference of digits, as the runtime does', () => {
-  expect(read({ price: '$100' })).toEqual([{ depth: 0, key: 'price', value: null, secret: true }])
-})
-
-it('should not take a lowercase or unprefixed name for a secret', () => {
-  expect(read({ word: '$lower', plain: 'NAME' })).toEqual([
-    { depth: 0, key: 'word', value: '$lower', secret: false },
-    { depth: 0, key: 'plain', value: 'NAME', secret: false },
-  ])
-})
-
-it('should say whether a configuration holds a secret', () => {
-  expect(holds({ foo: 'plain' })).toBe(false)
-  expect(holds({ apiKey: '$STRIPE_API_KEY' })).toBe(true)
-  expect(holds({ nested: { deep: { key: '$KEY0' } } })).toBe(true)
-  expect(holds({ keys: [{ key: '$KEY0' }] })).toBe(true)
-  expect(holds({})).toBe(false)
-})

package/ui/src/@/configuration/ui/read.ts

@@ -1,102 +0,0 @@
-/**
- * A configuration read as lines: what each value is, and what the things it hold are.
- * The sibling of introspection's `shape.ts` — that one reads a schema, this one reads
- * the value the schema describes.
- *
- * A secret never reaches the page: what is stored in its place is a reference to the
- * variable the component substitutes, and a reference is all there is to show.
- */
-
-/** One line of the value, indented by its depth. */
-export interface Line {
-  depth: number
-  /** The property this line is about; `-` marks an item of a list. */
-  key: string
-  /** What is written after the key, or null where the line opens onto the lines beneath. */
-  value: string | null
-  /** Stored as a reference, and shown as one. */
-  secret: boolean
-}
-
-/**
- * A secret is an uppercase name prefixed with `$`. Mirrors `SECRET_RX` in
- * `extensions/configuration/source/const.ts`; the two must say the same thing.
- */
-const SECRET = /^\$([A-Z0-9_]{1,32})$/
-
-/** The marker a list item is written with, in place of a key. */
-export const ITEM = '-'
-
-export function read(value: unknown): Line[] {
-  const lines: Line[] = []
-
-  add(null, value, 0, lines)
-
-  return lines
-}
-
-function add(key: string | null, value: unknown, depth: number, into: Line[]): void {
-  const held = open(value)
-
-  // the whole of what is shown needs no line of its own; its children are the shape
-  if (key === null) {
-    if (held === null) into.push(line(ITEM, value, depth))
-    else for (const [name, child] of held) add(name, child, depth, into)
-
-    return
-  }
-
-  if (held === null) {
-    into.push(line(key, value, depth))
-
-    return
-  }
-
-  into.push({ depth, key, value: null, secret: false })
-
-  for (const [name, child] of held) add(name, child, depth + 1, into)
-}
-
-/**
- * The pairs a line opens onto, or `null` when the value is written on the line itself.
- * An empty object or list opens onto nothing, so it is written rather than opened.
- */
-function open(value: unknown): Array<[string, unknown]> | null {
-  if (Array.isArray(value))
-    return value.length === 0 ? null : value.map((item) => [ITEM, item])
-
-  if (typeof value === 'object' && value !== null) {
-    const entries = Object.entries(value)
-
-    return entries.length === 0 ? null : entries
-  }
-
-  return null
-}
-
-function line(key: string, value: unknown, depth: number): Line {
-  const secret = typeof value === 'string' && SECRET.test(value)
-
-  return { depth, key, value: secret ? null : write(value), secret }
-}
-
-/** How a value is written: a string as it reads, everything else as JSON says. */
-function write(value: unknown): string {
-  if (typeof value === 'string') return value
-
-  if (Array.isArray(value)) return '[]'
-
-  if (typeof value === 'object' && value !== null) return '{}'
-
-  return JSON.stringify(value) ?? 'null'
-}
-
-/** Whether a value is a secret reference, for anything that asks outside a line. */
-export function secret(value: unknown): boolean {
-  return typeof value === 'string' && SECRET.test(value)
-}
-
-/** Whether a configuration holds a secret anywhere in it, however deep. */
-export function holds(value: unknown): boolean {
-  return read(value).some((line) => line.secret)
-}

package/ui/src/@/configuration/ui/ui.test.ts

@@ -1,69 +0,0 @@
-import { it, expect } from 'vitest'
-import { matches, rank, split } from './ui'
-
-it('should split a namespaced name', () => {
-  expect(split('identity.tokens')).toEqual({ namespace: 'identity', component: 'tokens' })
-})
-
-it('should read an unqualified name as the default namespace', () => {
-  expect(split('dummy')).toEqual({ namespace: 'default', component: 'dummy' })
-})
-
-it('should split on the first dot only', () => {
-  expect(split('a.b.c')).toEqual({ namespace: 'a', component: 'b.c' })
-})
-
-it('should match a subsequence', () => {
-  expect(matches('identity.tokens', 'idtok')).toBe(true)
-  expect(matches('identity.tokens', 'identity tokens')).toBe(true)
-  expect(matches('identity.tokens', '')).toBe(true)
-  expect(matches('identity.tokens', 'zzz')).toBe(false)
-})
-
-const dummy = {
-  component: 'dummies.dummy',
-  configuration: {
-    foo: 'deployed',
-    num: 7,
-    nested: { deep: { flag: true } },
-    greetings: [{ text: 'hello' }],
-    apiKey: '$STRIPE_API_KEY',
-  },
-}
-
-it('should rank a name above what a configuration holds', () => {
-  expect(rank(dummy, 'dummy')).toBeGreaterThan(rank(dummy, 'deployed'))
-})
-
-it('should match a top-level key and value', () => {
-  expect(rank(dummy, 'foo')).toBe(1)
-  expect(rank(dummy, 'deployed')).toBe(1)
-})
-
-it('should match a nested key and value', () => {
-  expect(rank(dummy, 'deep')).toBe(1)
-  expect(rank(dummy, 'flag')).toBe(1)
-})
-
-it('should match inside a list of objects', () => {
-  expect(rank(dummy, 'hello')).toBe(1)
-  expect(rank(dummy, 'text')).toBe(1)
-})
-
-it('should match a number or a boolean', () => {
-  expect(rank(dummy, '7')).toBe(1)
-  expect(rank(dummy, 'true')).toBe(1)
-})
-
-it('should match the key of a secret but never its reference', () => {
-  expect(rank(dummy, 'apiKey')).toBe(1)
-  expect(rank(dummy, 'STRIPE')).toBe(0)
-})
-
-it('should not match across two unrelated values', () => {
-  expect(rank(dummy, 'deployedhello')).toBe(0)
-})
-
-it('should keep every component on an empty query', () => {
-  expect(rank(dummy, '')).toBe(2)
-})

package/ui/src/@/configuration/ui/ui.ts

@@ -1,115 +0,0 @@
-import { writable } from 'svelte/store'
-
-/** What the header's filter holds. Transient: not persisted, not in the URL. */
-export const query = writable('')
-
-/**
- * What Enter in the filter does, set by whichever screen is showing. A filter narrowed to
- * one thing leaves nothing to choose, so the key does what pressing that thing does; with
- * none or many left there is nothing to mean by it.
- */
-export const only = writable<(() => void) | null>(null)
-
-/** The namespace an application does not name; it is noise on every row. */
-export const DEFAULT = 'default'
-
-/** The namespace of a component, and the name under it. */
-export function split(id: string): { namespace: string; component: string } {
-  const at = id.indexOf('.')
-
-  if (at === -1) return { namespace: DEFAULT, component: id }
-
-  return { namespace: id.slice(0, at), component: id.slice(at + 1) }
-}
-
-/**
- * The namespaces the runtime provides components in. Configuration has no notion of a
- * system component — what the service is told is a name and a schema — so this is a
- * list, and it grows when the runtime ships another one. It must keep saying what
- * `SYSTEM` says in the introspection UI.
- */
-const SYSTEM = new Set(['identity', 'exposition', 'realtime', 'introspection', 'configuration'])
-
-/** Whether a component came with the runtime rather than with the application. */
-export function system(component: string): boolean {
-  return SYSTEM.has(split(component).namespace)
-}
-
-/** A name match outranks a match on something the configuration merely holds. */
-const NAME = 2
-const MEMBER = 1
-
-type Searchable = { component: string; configuration: object }
-
-/**
- * How well a component answers the filter, or `0` when it does not. Someone typing
- * `apps` means the component of that name before a value that happens to read the
- * same, so the list leads with names.
- *
- * An empty query matches every name, which leaves the order alone.
- */
-export function rank(item: Searchable, query: string): number {
-  if (matches(item.component, query)) return NAME
-
-  return terms(item.configuration).some((term) => matches(term, query)) ? MEMBER : 0
-}
-
-/**
- * Every key and every value in a configuration, at any depth, each as its own term —
- * never a concatenation of them, or a query would creep across two unrelated values
- * and call it a hit.
- *
- * A secret is left out. What stands in its place is a reference rather than the secret,
- * but the page refuses to show it, and a filter that answered for it would show it.
- */
-function terms(value: unknown, into: string[] = []): string[] {
-  if (Array.isArray(value)) {
-    for (const item of value) terms(item, into)
-
-    return into
-  }
-
-  if (typeof value === 'object' && value !== null) {
-    for (const [key, held] of Object.entries(value)) {
-      into.push(key)
-      terms(held, into)
-    }
-
-    return into
-  }
-
-  if (typeof value === 'string') {
-    if (!SECRET.test(value)) into.push(value)
-
-    return into
-  }
-
-  if (typeof value === 'number' || typeof value === 'boolean') into.push(String(value))
-
-  return into
-}
-
-/** Mirrors `SECRET_RX` in `extensions/configuration/source/const.ts`. */
-const SECRET = /^\$([A-Z0-9_]{1,32})$/
-
-/**
- * A subsequence match, so `idtok` finds `identity.tokens`. Spaces in the query are
- * dropped, which lets `identity tokens` find it too. An empty query matches everything.
- */
-export function matches(text: string, query: string): boolean {
-  const needle = query.toLowerCase().replace(/\s+/g, '')
-
-  if (needle === '') return true
-
-  const haystack = text.toLowerCase()
-
-  let at = 0
-
-  for (const character of needle) {
-    at = haystack.indexOf(character, at) + 1
-
-    if (at === 0) return false
-  }
-
-  return true
-}

package/ui/src/@/iam/index.ts

@@ -1 +0,0 @@
-export * from './svc'

package/ui/src/@/iam/rc.ts

@@ -1,22 +0,0 @@
-import { origin } from '@/net'
-import { consume } from './svc/transfer'
-import { sync } from './svc/sync'
-import { challenge } from './svc/store'
-
-function rc() {
-  origin.events.on('challenge', (value) => challenge.set(value))
-
-  origin.events.on('error', (error) => {
-    if (error.code === 401) challenge.set(null)
-  })
-
-  challenge.subscribe((challenge) => origin.authenticate(challenge))
-
-  const transferred = consume()
-
-  if (transferred !== null) challenge.set(transferred)
-
-  void sync()
-}
-
-export { rc }

package/ui/src/@/iam/svc/authenticated.ts

@@ -1,17 +0,0 @@
-import { iam, method, type Method } from './store'
-import type { Echo } from './net'
-
-/**
- * Set current account and authentication method.
- *
- * @param echo - The authenticated account echo (`201` on first registration, else `200`).
- * @param channel - The auth channel the user authenticated through.
- */
-export function authenticated(echo: Echo | Error, channel: Method): Echo | Error {
-  if (echo instanceof Error) return echo
-
-  iam(echo)
-  method.set(channel)
-
-  return echo
-}

package/ui/src/@/iam/svc/basic.ts

@@ -1,23 +0,0 @@
-import { sync } from './sync'
-import * as net from './net'
-import { authenticated } from './authenticated'
-import type { Echo } from './net'
-
-export async function verify(username: string, password: string): Promise<Echo | Error> {
-  const credentials = btoa(`${username}:${password}`)
-  const echo = await net.get('Basic ' + credentials)
-
-  return authenticated(echo, 'password')
-}
-
-export async function create(identity: string, body: net.basic.Basic): Promise<void | Error> {
-  return await net.basic.post(identity, body)
-}
-
-export async function capture(identity: string, body: net.basic.Basic): Promise<void | Error> {
-  const created = await create(identity, body)
-
-  if (created instanceof Error) return created
-
-  void sync()
-}

package/ui/src/@/iam/svc/index.ts

@@ -1,10 +0,0 @@
-export * as oidc from './oidc'
-export { apple } from './oidc/apple'
-export { google } from './oidc/google'
-export { logout } from './logout'
-export { update } from './update'
-export { named } from './named'
-export * from './store'
-export * as basic from './basic'
-export * as otp from './otp'
-export * as passkeys from './passkeys'

package/ui/src/@/iam/svc/logout.ts

@@ -1,5 +0,0 @@
-import { account } from './store'
-
-export function logout() {
-  account.set(null)
-}

package/ui/src/@/iam/svc/named.ts

@@ -1,16 +0,0 @@
-import { account } from './store'
-
-export async function named(): Promise<string> {
-  const current = account.extract()
-
-  if (current?.name !== undefined) return current.name
-
-  return new Promise<string>((resolve) => {
-    const unsubscribe = account.subscribe((acc) => {
-      if (acc?.name !== undefined) {
-        unsubscribe()
-        resolve(acc.name)
-      }
-    })
-  })
-}

package/ui/src/@/iam/svc/net/Echo.ts

@@ -1,9 +0,0 @@
-import type { Grammar } from '$lib/intl'
-
-export interface Echo {
-  id: string
-  roles: string[]
-  name?: string
-  locale?: string
-  grammar?: Grammar | null
-}

package/ui/src/@/iam/svc/net/basic/index.ts

@@ -1 +0,0 @@
-export * from './interface'

package/ui/src/@/iam/svc/net/basic/interface.ts

@@ -1,15 +0,0 @@
-import { origin } from '@/net'
-
-const basic = origin.resource('/identity/basic/', { credentials: 'include' })
-
-export interface Basic {
-  username: string
-  password: string
-}
-
-export async function post(id: string, body: Basic): Promise<void | Error> {
-  return await basic.json(id, {
-    method: 'POST',
-    body,
-  })
-}

package/ui/src/@/iam/svc/net/federation/index.ts

@@ -1 +0,0 @@
-export * from './interface'

package/ui/src/@/iam/svc/net/federation/interface.ts

@@ -1,12 +0,0 @@
-import { origin } from '@/net'
-
-const federation = origin.resource('/identity/federation/', { credentials: 'include' })
-
-interface Post {
-  scheme: 'bearer' | 'code'
-  credentials: string
-}
-
-export async function post(identity: string, body: Post): Promise<void | Error> {
-  return await federation.json(identity, { method: 'POST', body })
-}

package/ui/src/@/iam/svc/net/index.ts

@@ -1,6 +0,0 @@
-export * from './interface'
-export * as basic from './basic'
-export * as otp from './otp'
-export * as passkeys from './passkeys'
-export * as federation from './federation'
-export type { Echo } from './Echo'