dtoro
d4d99a7473
Problem: the hexagonal refactor churns the backend tree for nine more phases; the UI delivery stack (web/ SPA, cmd/desktop Wails wrapper, compose/web image) must move to its own repo first so doc/layout rewrites land once on a backend-only tree. Change: - New repo git.hubris.network/dtoro/oikos-web (v0.33.0): web/, desktop/ (updateURL repointed to oikos-web releases), compose/, own CI (web + desktop jobs), own deploy script (CI-green gate, TOCTOU guard, version-tagged images, prune-to-3), own webhook receiver on :9798 + launchd unit, own compose project publishing the same 8091:80. - Cutover executed on mac-mini in order: oikos stack's web service stopped+removed, oikos-web project brought up on 8091; outer Caddy untouched (targets the published port) — serving + Authentik flow + /wails 404 quirk verified post-cutover. - Stripped from oikos: web/, cmd/desktop/, compose/web/, desktop CI workflow, ci.yml web job, Makefile ui/desktop/desktop-package/install targets, the compose web service, oikos-web from deploy.sh's fallback prune list; wails + go-keyring dropped from go.mod, vendor synced. - README / CONTRIBUTING / AGENTS.md / .agents dev+operations docs now point at the new repo; mbse + mascot design docs carry a path note. Risk: production SPA serving depends on the new pipeline now; rollback is versioned-image re-up of the old web service from a pre-split checkout (port 8091). Desktop builds installed before the split still check dtoro/oikos releases — one manual reinstall, noted in the oikos-web release notes. Verification: go vet, make test (race), make generate-check, golangci (no new findings; baseline down 400→365); post-cutover curls — localhost:8091 200, /wails/runtime.js 404, outer Caddy 302 Authentik.
92 lines
2.2 KiB
TypeScript
92 lines
2.2 KiB
TypeScript
/**
|
||
* Generate secure URL-friendly unique ID.
|
||
*
|
||
* By default, the ID will have 21 symbols to have a collision probability
|
||
* similar to UUID v4.
|
||
*
|
||
* ```js
|
||
* import { nanoid } from 'nanoid'
|
||
* model.id = nanoid() //=> "Uakgb_J5m9g-0JDMbcJqL"
|
||
* ```
|
||
*
|
||
* @param size Size of the ID. The default size is 21.
|
||
* @returns A random string.
|
||
*/
|
||
export function nanoid(size?: number): string
|
||
|
||
/**
|
||
* Generate secure unique ID with custom alphabet.
|
||
*
|
||
* Alphabet must contain 256 symbols or less. Otherwise, the generator
|
||
* will not be secure.
|
||
*
|
||
* @param alphabet Alphabet used to generate the ID.
|
||
* @param defaultSize Size of the ID. The default size is 21.
|
||
* @returns A random string generator.
|
||
*
|
||
* ```js
|
||
* const { customAlphabet } = require('nanoid')
|
||
* const nanoid = customAlphabet('0123456789абвгдеё', 5)
|
||
* nanoid() //=> "8ё56а"
|
||
* ```
|
||
*/
|
||
export function customAlphabet(
|
||
alphabet: string,
|
||
defaultSize?: number
|
||
): (size?: number) => string
|
||
|
||
/**
|
||
* Generate unique ID with custom random generator and alphabet.
|
||
*
|
||
* Alphabet must contain 256 symbols or less. Otherwise, the generator
|
||
* will not be secure.
|
||
*
|
||
* ```js
|
||
* import { customRandom } from 'nanoid/format'
|
||
*
|
||
* const nanoid = customRandom('abcdef', 5, size => {
|
||
* const random = []
|
||
* for (let i = 0; i < size; i++) {
|
||
* random.push(randomByte())
|
||
* }
|
||
* return random
|
||
* })
|
||
*
|
||
* nanoid() //=> "fbaef"
|
||
* ```
|
||
*
|
||
* @param alphabet Alphabet used to generate a random string.
|
||
* @param size Size of the random string.
|
||
* @param random A random bytes generator.
|
||
* @returns A random string generator.
|
||
*/
|
||
export function customRandom(
|
||
alphabet: string,
|
||
size: number,
|
||
random: (bytes: number) => Uint8Array
|
||
): () => string
|
||
|
||
/**
|
||
* URL safe symbols.
|
||
*
|
||
* ```js
|
||
* import { urlAlphabet } from 'nanoid'
|
||
* const nanoid = customAlphabet(urlAlphabet, 10)
|
||
* nanoid() //=> "Uakgb_J5m9"
|
||
* ```
|
||
*/
|
||
export const urlAlphabet: string
|
||
|
||
/**
|
||
* Generate an array of random bytes collected from hardware noise.
|
||
*
|
||
* ```js
|
||
* import { customRandom, random } from 'nanoid'
|
||
* const nanoid = customRandom("abcdef", 5, random)
|
||
* ```
|
||
*
|
||
* @param bytes Size of the array.
|
||
* @returns An array of random bytes.
|
||
*/
|
||
export function random(bytes: number): Uint8Array
|