@astrale-os/sdk 0.6.0-beta.43 → 0.6.0-beta.45

package/dist/application/query/recipe/define.js

@@ -1,95 +0,0 @@
-import { rememberRecipeErrors } from '../../error/error.js';
-import { describe } from '../handles/terms.js';
-import { defineQuery as defineV6Query } from '../legacy/v6/define.js';
-/** A recipe id: lowercase segments of letters, digits and hyphens, joined by dots. */
-export const RECIPE_ID = /^[a-z0-9-]+(?:\.[a-z0-9-]+)*$/u;
-export const MAXIMUM_RECIPE_ID = 128;
-const FIELDS = new Set(['build', 'output', 'errors']);
-const specs = new WeakMap();
-/** The collections open while a build loads a Domain; no recipe is kept outside one. */
-const collections = new Set();
-/** The build and the output of a v7 recipe; `undefined` for anything else. */
-export function recipeSpecOf(recipe) {
-    return typeof recipe === 'object' && recipe !== null ? specs.get(recipe) : undefined;
-}
-function defineRecipe(id, spec) {
-    if (typeof id !== 'string' || id.length > MAXIMUM_RECIPE_ID || !RECIPE_ID.test(id))
-        throw new TypeError(`A recipe id is lowercase segments of letters, digits and hyphens joined by dots, at most ${MAXIMUM_RECIPE_ID} characters ('services.service.owner'); got ${describe(id)}.`);
-    if (typeof spec !== 'object' || spec === null || Array.isArray(spec))
-        throw new TypeError(`Recipe ${id} takes { build, output?, errors? }; got ${describe(spec)}.`);
-    const fields = spec;
-    const unknown = Reflect.ownKeys(fields).filter((key) => typeof key !== 'string' || !FIELDS.has(key));
-    if (unknown.length > 0)
-        throw new TypeError(`Recipe ${id} takes build, output and errors only; got ${unknown.map(String).join(', ')}: do that work in build or output.`);
-    const { build, output } = fields;
-    if (typeof build !== 'function')
-        throw new TypeError(`Recipe ${id}'s build is a function of (input, d, steps) that returns a read, a record of facets, or steps(first, (earlier) => next, …); got ${describe(build)}.`);
-    if (output !== undefined && typeof output !== 'function')
-        throw new TypeError(`Recipe ${id}'s output is a function of (results, input, context); got ${describe(output)}.`);
-    const errors = fields.errors ?? {};
-    if (typeof errors !== 'object' || errors === null || Array.isArray(errors))
-        throw new TypeError(`Recipe ${id}'s errors is a record of declared errors by UPPER_SNAKE code; got ${describe(errors)}.`);
-    const recipe = Object.freeze({ id, errors: Object.freeze({ ...errors }) });
-    collectRecipe(recipe);
-    specs.set(recipe, Object.freeze({
-        build: build,
-        ...(output !== undefined ? { output: output } : {}),
-    }));
-    return recipe;
-}
-/**
- * Keep the errors a recipe declares, a Query's or a Mutation's, and collect it into the
- * collections open: a Mutation recipe shares its Domain's recipe ids and error definitions.
- */
-export function collectRecipe(recipe) {
-    rememberRecipeErrors(recipe, recipe.id, recipe.errors);
-    for (const collection of collections)
-        collection.push(recipe);
-}
-/**
- * Collect into `recipes` each recipe defined while `load` runs: a build collects the recipes that
- * loading its Domain defines, and checks them with `admitRecipes`. A module an earlier load of
- * the same process evaluated defines nothing again, so its recipes were checked with that load.
- */
-export async function collectRecipes(recipes, load) {
-    collections.add(recipes);
-    try {
-        return await load();
-    }
-    finally {
-        collections.delete(recipes);
-    }
-}
-/**
- * Refuse two recipes of one Domain under one id: a refusal and a call name a recipe by its id.
- * Refuse two that declare one code with different definitions: a Function that spreads both
- * recipes' errors keeps one of them, and would redact the other recipe's error.
- */
-export function admitRecipes(recipes) {
-    const ids = new Set();
-    for (const { id } of recipes) {
-        if (ids.has(id))
-            throw new TypeError(`Two recipes of the Domain are named ${id}: a recipe id is unique in its Domain.`);
-        ids.add(id);
-    }
-    const first = new Map();
-    for (const recipe of recipes) {
-        for (const [code, declaration] of Object.entries(recipe.errors)) {
-            const seen = first.get(code);
-            if (seen === undefined)
-                first.set(code, { recipe: recipe.id, declaration });
-            else if (seen.declaration !== declaration)
-                throw new TypeError(`Recipes ${seen.recipe} and ${recipe.id} declare ${code} with different definitions: declare it once and share that object, so a Function that re-declares both keeps each.`);
-        }
-    }
-}
-/**
- * Define a recipe: `defineQuery<Schema>()('services.service.owner', { build, output?, errors? })`.
- * The V6 form, `defineQuery<Schema>()((domain) => ({ id, build, project? }))`, stays.
- */
-export function defineQuery() {
-    const v6 = defineV6Query();
-    return ((first, spec) => typeof first === 'string'
-        ? defineRecipe(first, spec)
-        : v6(first));
-}

package/dist/execution/invocation/result/recipe.d.ts

@@ -1,6 +0,0 @@
-/**
- * Log a recipe's declared error that reaches a Function which does not re-declare it, before the
- * Server redacts it as an internal error: its code, the recipe and the Function, never its details,
- * which a recipe read as the executor may fill with what the caller may not read.
- */
-export declare function reportUndeclaredRecipeError(cause: unknown, address: string): void;

package/dist/execution/invocation/result/recipe.js

@@ -1,17 +0,0 @@
-import { recipeErrorOf } from '../../../application/error/index.js';
-/**
- * Log a recipe's declared error that reaches a Function which does not re-declare it, before the
- * Server redacts it as an internal error: its code, the recipe and the Function, never its details,
- * which a recipe read as the executor may fill with what the caller may not read.
- */
-export function reportUndeclaredRecipeError(cause, address) {
-    const raised = recipeErrorOf(cause);
-    if (raised === undefined)
-        return;
-    // oxlint-disable-next-line no-console
-    console.error('[sdk] Recipe error not re-declared by its Function', {
-        code: raised.code,
-        recipe: raised.recipe,
-        function: address,
-    });
-}

package/dist/tooling/linter/implementations/source/recipes.d.ts

@@ -1,2 +0,0 @@
-import type { SourceRuleVerifier } from './verifier.js';
-export declare const recipeRules: readonly SourceRuleVerifier[];