@start9labs/start-sdk 0.4.0-beta.5 → 0.4.0-beta.50

package/package/lib/StartSdk.js

@@ -43,37 +43,38 @@ const patterns = __importStar(require("../../base/lib/util/patterns"));
 const Backups_1 = require("./backup/Backups");
 const inputSpecConstants_1 = require("../../base/lib/actions/input/inputSpecConstants");
 const Daemons_1 = require("./mainFn/Daemons");
-const HealthCheck_1 = require("./health/HealthCheck");
 const checkPortListening_1 = require("./health/checkFns/checkPortListening");
 const checkFns_1 = require("./health/checkFns");
 const list_1 = require("../../base/lib/actions/input/builder/list");
-const setupInstall_1 = require("./inits/setupInstall");
 const setupBackups_1 = require("./backup/setupBackups");
-const setupUninstall_1 = require("./inits/setupUninstall");
 const mainFn_1 = require("./mainFn");
 const defaultTrigger_1 = require("./trigger/defaultTrigger");
 const trigger_1 = require("./trigger");
 const setupInterfaces_1 = require("../../base/lib/interfaces/setupInterfaces");
+const setupExportedUrls_1 = require("../../base/lib/interfaces/setupExportedUrls");
 const successFailure_1 = require("./trigger/successFailure");
 const Host_1 = require("../../base/lib/interfaces/Host");
 const ServiceInterfaceBuilder_1 = require("../../base/lib/interfaces/ServiceInterfaceBuilder");
 const util_1 = require("./util");
 const util_2 = require("./util");
 const util_3 = require("./util");
-const getStore_1 = require("./store/getStore");
 const SubContainer_1 = require("./util/SubContainer");
 const util_4 = require("./util");
 const Mounts_1 = require("./mainFn/Mounts");
 const setupDependencies_1 = require("../../base/lib/dependencies/setupDependencies");
 const T = __importStar(require("../../base/lib/types"));
 const exver_1 = require("../../base/lib/exver");
-const PathBuilder_1 = require("../../base/lib/util/PathBuilder");
 const dependencies_1 = require("../../base/lib/dependencies/dependencies");
 const util_5 = require("./util");
+const version_1 = require("./version");
 const actions = __importStar(require("../../base/lib/actions"));
-const setupInit_1 = require("./inits/setupInit");
 const fs = __importStar(require("node:fs/promises"));
-exports.OSVersion = (0, exver_1.testTypeVersion)("0.4.0-alpha.0");
+const inits_1 = require("../../base/lib/inits");
+const Drop_1 = require("../../base/lib/util/Drop");
+const getServiceInterface_1 = require("../../base/lib/util/getServiceInterface");
+const getServiceInterfaces_1 = require("../../base/lib/util/getServiceInterfaces");
+const Volume_1 = require("./util/Volume");
+exports.OSVersion = (0, exver_1.testTypeVersion)('0.4.0-alpha.20');
 class StartSdk {
     constructor(manifest) {
         this.manifest = manifest;
@@ -84,8 +85,10 @@ class StartSdk {
     withManifest(manifest) {
         return new StartSdk(manifest);
     }
-    withStore() {
-        return new StartSdk(this.manifest);
+    ifPluginEnabled(plugin, value) {
+        if (this.manifest.plugins?.includes(plugin))
+            return value;
+        return null;
     }
     build(isReady) {
         const startSdkEffectWrapper = {
@@ -94,54 +97,54 @@ class StartSdk {
             checkDependencies: (effects, ...args) => effects.checkDependencies(...args),
             mount: (effects, ...args) => effects.mount(...args),
             getInstalledPackages: (effects, ...args) => effects.getInstalledPackages(...args),
-            exposeForDependents: (effects, ...args) => effects.exposeForDependents(...args),
             getServicePortForward: (effects, ...args) => effects.getServicePortForward(...args),
             clearBindings: (effects, ...args) => effects.clearBindings(...args),
             getOsIp: (effects, ...args) => effects.getOsIp(...args),
             getSslKey: (effects, ...args) => effects.getSslKey(...args),
-            setDataVersion: (effects, ...args) => effects.setDataVersion(...args),
-            getDataVersion: (effects, ...args) => effects.getDataVersion(...args),
             shutdown: (effects, ...args) => effects.shutdown(...args),
             getDependencies: (effects, ...args) => effects.getDependencies(...args),
             getStatus: (effects, ...args) => effects.getStatus(...args),
+            setHealth: (effects, ...args) => effects.setHealth(...args),
         };
         return {
             manifest: this.manifest,
+            volumes: (0, Volume_1.createVolumes)(this.manifest),
             ...startSdkEffectWrapper,
+            setDataVersion: version_1.setDataVersion,
+            getDataVersion: version_1.getDataVersion,
             action: {
                 run: actions.runAction,
-                request: (effects, packageId, action, severity, options) => actions.requestAction({
+                createTask: (effects, packageId, action, severity, options) => actions.createTask({
                     effects,
                     packageId,
                     action,
                     severity,
                     options: options,
                 }),
-                requestOwn: (effects, action, severity, options) => actions.requestAction({
+                createOwnTask: (effects, action, severity, options) => actions.createTask({
                     effects,
                     packageId: this.manifest.id,
                     action,
                     severity,
                     options: options,
                 }),
-                clearRequest: (effects, ...replayIds) => effects.action.clearRequests({ only: replayIds }),
+                clearTask: (effects, ...replayIds) => effects.action.clearTasks({ only: replayIds }),
             },
             checkDependencies: dependencies_1.checkDependencies,
             serviceInterface: {
-                getOwn: (effects, id) => (0, util_3.getServiceInterface)(effects, {
-                    id,
-                }),
-                get: (effects, opts) => (0, util_3.getServiceInterface)(effects, opts),
-                getAllOwn: (effects) => (0, util_3.getServiceInterfaces)(effects, {}),
-                getAll: (effects, opts) => (0, util_3.getServiceInterfaces)(effects, opts),
+                getOwn: getServiceInterface_1.getOwnServiceInterface,
+                get: util_3.getServiceInterface,
+                getAllOwn: getServiceInterfaces_1.getOwnServiceInterfaces,
+                getAll: util_3.getServiceInterfaces,
             },
             getContainerIp: (effects, options = {}) => {
-                async function* watch() {
+                async function* watch(abort) {
                     const resolveCell = { resolve: () => { } };
                     effects.onLeaveContext(() => {
                         resolveCell.resolve();
                     });
-                    while (effects.isInContext) {
+                    abort?.addEventListener('abort', () => resolveCell.resolve());
+                    while (effects.isInContext && !abort?.aborted) {
                         let callback = () => { };
                         const waitForNext = new Promise((resolve) => {
                             callback = resolve;
@@ -158,46 +161,58 @@ class StartSdk {
                             (() => effects.constRetry && effects.constRetry()),
                     }),
                     once: () => effects.getContainerIp(options),
-                    watch,
+                    watch: (abort) => {
+                        const ctrl = new AbortController();
+                        abort?.addEventListener('abort', () => ctrl.abort());
+                        return Drop_1.DropGenerator.of(watch(ctrl.signal), () => ctrl.abort());
+                    },
                     onChange: (callback) => {
                         ;
                         (async () => {
-                            for await (const value of watch()) {
+                            const ctrl = new AbortController();
+                            for await (const value of watch(ctrl.signal)) {
                                 try {
-                                    await callback(value);
+                                    const res = await callback(value);
+                                    if (res.cancel) {
+                                        ctrl.abort();
+                                        break;
+                                    }
                                 }
                                 catch (e) {
-                                    console.error("callback function threw an error @ getContainerIp.onChange", e);
+                                    console.error('callback function threw an error @ getContainerIp.onChange', e);
                                 }
                             }
                         })()
                             .catch((e) => callback(null, e))
-                            .catch((e) => console.error("callback function threw an error @ getContainerIp.onChange", e));
+                            .catch((e) => console.error('callback function threw an error @ getContainerIp.onChange', e));
+                    },
+                    waitFor: async (pred) => {
+                        const resolveCell = { resolve: () => { } };
+                        effects.onLeaveContext(() => {
+                            resolveCell.resolve();
+                        });
+                        while (effects.isInContext) {
+                            let callback = () => { };
+                            const waitForNext = new Promise((resolve) => {
+                                callback = resolve;
+                                resolveCell.resolve = resolve;
+                            });
+                            const res = await effects.getContainerIp({ ...options, callback });
+                            if (pred(res)) {
+                                resolveCell.resolve();
+                                return res;
+                            }
+                            await waitForNext;
+                        }
+                        return null;
                     },
                 };
             },
-            store: {
-                get: (effects, packageId, path) => (0, getStore_1.getStore)(effects, path, {
-                    packageId,
-                }),
-                getOwn: (effects, path) => (0, getStore_1.getStore)(effects, path),
-                setOwn: (effects, path, value) => effects.store.set({
-                    value,
-                    path: (0, PathBuilder_1.extractJsonPath)(path),
-                }),
-            },
             MultiHost: {
                 of: (effects, id) => new Host_1.MultiHost({ id, effects }),
             },
             nullIfEmpty: util_2.nullIfEmpty,
             useEntrypoint: (overrideCmd) => new T.UseEntrypoint(overrideCmd),
-            runCommand: async (effects, image, command, options, 
-            /**
-             * A name to use to refer to the ephemeral subcontainer for debugging purposes
-             */
-            name) => {
-                return runCommand(effects, image, command, options, name);
-            },
             /**
              * @description Use this class to create an Action. By convention, each Action should receive its own file.
              *
@@ -260,7 +275,7 @@ class StartSdk {
                   )
                  * ```
                 */
-                withInput: (id, metadata, inputSpec, getInput, run) => setupActions_1.Action.withInput(id, metadata, inputSpec, getInput, run),
+                withInput: setupActions_1.Action.withInput,
                 /**
                  * @description Use this function to create an action that does not accept form input
                  * @param id - a unique ID for this action
@@ -270,6 +285,7 @@ class StartSdk {
                  * In this example, we create an action that returns a secret phrase for the user to see.
                  *
                  * ```
+                  import { store } from '../file-models/store.json'
                   import { sdk } from '../sdk'
         
                   export const showSecretPhrase = sdk.Action.withoutInput(
@@ -294,9 +310,7 @@ class StartSdk {
                         'Below is your secret phrase. Use it to gain access to extraordinary places',
                       result: {
                         type: 'single',
-                        value: await sdk.store
-                          .getOwn(effects, sdk.StorePath.secretPhrase)
-                          .const(),
+                        value: (await store.read.once())?.secretPhrase,
                         copyable: true,
                         qr: true,
                         masked: true,
@@ -325,14 +339,14 @@ class StartSdk {
                 schemeOverride: null,
                 username: null,
                 path: '',
-                search: {},
+                query: {},
               })
              * ```
              */
             createInterface: (effects, options) => new ServiceInterfaceBuilder_1.ServiceInterfaceBuilder({ ...options, effects }),
             getSystemSmtp: (effects) => new util_1.GetSystemSmtp(effects),
-            getSslCerificate: (effects, hostnames, algorithm) => new util_5.GetSslCertificate(effects, hostnames, algorithm),
-            HealthCheck: HealthCheck_1.HealthCheck,
+            getSslCertificate: (effects, hostnames, algorithm) => new util_5.GetSslCertificate(effects, hostnames, algorithm),
+            getServiceManifest: util_5.getServiceManifest,
             healthCheck: {
                 checkPortListening: checkPortListening_1.checkPortListening,
                 checkWebUrl: checkFns_1.checkWebUrl,
@@ -383,11 +397,11 @@ class StartSdk {
             /**
              * @description Use this function to set dependency information.
              * @example
-             * In this example, we create a perpetual dependency on Hello World >=1.0.0:0, where Hello World must be running and passing its "primary" health check.
+             * In this example, we create a dependency on Hello World >=1.0.0:0, where Hello World must be running and passing its "primary" health check.
              *
              * ```
               export const setDependencies = sdk.setupDependencies(
-                async ({ effects, input }) => {
+                async ({ effects }) => {
                   return {
                     'hello-world': {
                       kind: 'running',
@@ -398,66 +412,57 @@ class StartSdk {
                 },
               )
              * ```
-             * @example
-             * In this example, we create a conditional dependency on Hello World based on a hypothetical "needsWorld" boolean in our Store.
-             * Using .const() ensures that if the "needsWorld" boolean changes, setupDependencies will re-run.
-             *
-             * ```
-              export const setDependencies = sdk.setupDependencies(
-                async ({ effects }) => {
-                  if (sdk.store.getOwn(sdk.StorePath.needsWorld).const()) {
-                    return {
-                      'hello-world': {
-                        kind: 'running',
-                        versionRange: '>=1.0.0',
-                        healthChecks: ['primary'],
-                      },
-                    }
-                  }
-                  return {}
-                },
-              )
-             * ```
              */
             setupDependencies: (setupDependencies_1.setupDependencies),
-            setupInit: (setupInit_1.setupInit),
             /**
-             * @description Use this function to execute arbitrary logic *once*, on initial install *before* interfaces, actions, and dependencies are updated.
+             * @description Use this function to create an InitScript that runs every time the service initializes (install, update, restore, rebuild, and server bootup)
+             */
+            setupOnInit: inits_1.setupOnInit,
+            /**
+             * @description Use this function to create an UninitScript that runs every time the service uninitializes (update, uninstall, and server shutdown)
+             */
+            setupOnUninit: inits_1.setupOnUninit,
+            /**
+             * @description Use this function to setup what happens when the service initializes.
+             *
+             *    This happens when the server boots, or a service is installed, updated, or restored
+             *
+             *    Not every init script does something on every initialization. For example, versions only does something on install or update
+             *
+             *    These scripts are run in the order they are supplied
              * @example
-             * In the this example, we initialize a config file
              *
              * ```
-              const preInstall = sdk.setupPreInstall(async ({ effects }) => {
-                await configFile.write(effects, { name: 'World' })
-              })
+              export const init = sdk.setupInit(
+                restoreInit,
+                versions,
+                setDependencies,
+                setInterfaces,
+                actions,
+                postInstall,
+              )
              * ```
              */
-            setupPreInstall: (fn) => setupInstall_1.PreInstall.of(fn),
+            setupInit: inits_1.setupInit,
             /**
-             * @description Use this function to execute arbitrary logic *once*, on initial install *after* interfaces, actions, and dependencies are updated.
+             * @description Use this function to setup what happens when the service uninitializes.
+             *
+             *    This happens when the server shuts down, or a service is uninstalled or updated
+             *
+             *    Not every uninit script does something on every uninitialization. For example, versions only does something on uninstall or update
+             *
+             *    These scripts are run in the order they are supplied
              * @example
-             * In the this example, we bootstrap our Store with a random, 16-char admin password.
              *
              * ```
-              const postInstall = sdk.setupPostInstall(async ({ effects }) => {
-                await sdk.store.setOwn(
-                  effects,
-                  sdk.StorePath.adminPassword,
-                  utils.getDefaultString({
-                    charset: 'a-z,A-Z,1-9,!,@,$,%,&,',
-                    len: 16,
-                  }),
-                )
-              })
+              export const uninit = sdk.setupUninit(
+                versions,
+              )
              * ```
              */
-            setupPostInstall: (fn) => setupInstall_1.PostInstall.of(fn),
+            setupUninit: inits_1.setupUninit,
             /**
              * @description Use this function to determine how this service will be hosted and served. The function executes on service install, service update, and inputSpec save.
-             *
-             *   "input" will be of type `Input` for inputSpec save. It will be `null` for install and update.
-             *
-             *   To learn about creating multi-hosts and interfaces, check out the {@link https://docs.start9.com/packaging-guide/learn/interfaces documentation}.
              * @param inputSpec - The inputSpec spec of this service as exported from /inputSpec/spec.
              * @param fn - an async function that returns an array of interface receipts. The function always has access to `effects`; it has access to `input` only after inputSpec save, otherwise `input` will be null.
              * @example
@@ -465,8 +470,7 @@ class StartSdk {
              *
              * ```
               export const setInterfaces = sdk.setupInterfaces(
-                inputSpecSpec,
-                async ({ effects, input }) => {
+                async ({ effects }) => {
                   // ** UI multi-host **
                   const uiMulti = sdk.MultiHost.of(effects, 'ui-multi')
                   const uiMultiOrigin = await uiMulti.bindPort(80, {
@@ -482,7 +486,7 @@ class StartSdk {
                     schemeOverride: null,
                     username: null,
                     path: '',
-                    search: {},
+                    query: {},
                   })
                   // Admin UI
                   const adminUi = sdk.createInterface(effects, {
@@ -494,7 +498,7 @@ class StartSdk {
                     schemeOverride: null,
                     username: null,
                     path: '/admin',
-                    search: {},
+                    query: {},
                   })
                   // UI receipt
                   const uiReceipt = await uiMultiOrigin.export([primaryUi, adminUi])
@@ -514,7 +518,7 @@ class StartSdk {
                     schemeOverride: null,
                     username: null,
                     path: '',
-                    search: {},
+                    query: {},
                   })
                   // API receipt
                   const apiReceipt = await apiMultiOrigin.export([api])
@@ -527,10 +531,6 @@ class StartSdk {
              */
             setupInterfaces: setupInterfaces_1.setupServiceInterfaces,
             setupMain: (fn) => (0, mainFn_1.setupMain)(fn),
-            /**
-             * Use this function to execute arbitrary logic *once*, on uninstall only. Most services will not use this.
-             */
-            setupUninstall: (fn) => (0, setupUninstall_1.setupUninstall)(fn),
             trigger: {
                 defaultTrigger: defaultTrigger_1.defaultTrigger,
                 cooldownTrigger: trigger_1.cooldownTrigger,
@@ -538,14 +538,12 @@ class StartSdk {
                 successFailure: successFailure_1.successFailure,
             },
             Mounts: {
-                of() {
-                    return Mounts_1.Mounts.of();
-                },
+                of: (Mounts_1.Mounts.of),
             },
             Backups: {
-                volumes: (...volumeNames) => Backups_1.Backups.withVolumes(...volumeNames),
-                addSets: (...options) => Backups_1.Backups.withSyncs(...options),
-                withOptions: (options) => Backups_1.Backups.withOptions(options),
+                ofVolumes: (Backups_1.Backups.ofVolumes),
+                ofSyncs: (Backups_1.Backups.ofSyncs),
+                withOptions: (Backups_1.Backups.withOptions),
             },
             InputSpec: {
                 /**
@@ -577,9 +575,14 @@ class StartSdk {
                  */
                 of: (spec) => inputSpec_1.InputSpec.of(spec),
             },
+            Daemon: {
+                get of() {
+                    return Daemons_1.Daemon.of();
+                },
+            },
             Daemons: {
-                of(effects, started, healthChecks) {
-                    return Daemons_1.Daemons.of({ effects, started, healthChecks });
+                of(effects) {
+                    return Daemons_1.Daemons.of({ effects });
                 },
             },
             SubContainer: {
@@ -591,339 +594,34 @@ class StartSdk {
                  * @param name - a name to use to refer to the subcontainer for debugging purposes
                  */
                 of(effects, image, mounts, name) {
-                    return SubContainer_1.SubContainer.of(effects, image, mounts, name);
+                    return SubContainer_1.SubContainerOwned.of(effects, image, mounts, name).then((subc) => subc.rc());
                 },
                 /**
-                 * @description Create a new SubContainer
+                 * @description Run a function with a temporary SubContainer
                  * @param effects
                  * @param image - what container image to use
                  * @param mounts - what to mount to the subcontainer
                  * @param name - a name to use to refer to the ephemeral subcontainer for debugging purposes
                  */
-                with(effects, image, mounts, name, fn) {
-                    return SubContainer_1.SubContainer.with(effects, image, mounts, name, fn);
+                withTemp(effects, image, mounts, name, fn) {
+                    return SubContainer_1.SubContainerOwned.withTemp(effects, image, mounts, name, fn);
                 },
             },
-            List: {
-                /**
-                 * @description Create a list of text inputs.
-                 * @param a - attributes of the list itself.
-                 * @param aSpec - attributes describing each member of the list.
-                 */
-                text: list_1.List.text,
-                /**
-                 * @description Create a list of objects.
-                 * @param a - attributes of the list itself.
-                 * @param aSpec - attributes describing each member of the list.
-                 */
-                obj: (a, aSpec) => list_1.List.obj(a, aSpec),
-                /**
-                 * @description Create a list of dynamic text inputs.
-                 * @param a - attributes of the list itself.
-                 * @param aSpec - attributes describing each member of the list.
-                 */
-                dynamicText: (list_1.List.dynamicText),
-            },
-            StorePath: (0, PathBuilder_1.pathBuilder)(),
-            Value: {
-                /**
-                 * @description Displays a boolean toggle to enable/disable
-                 * @example
-                 * ```
-                  toggleExample: Value.toggle({
-                    // required
-                    name: 'Toggle Example',
-                    default: true,
-                 
-                    // optional
-                    description: null,
-                    warning: null,
-                    immutable: false,
-                  }),
-                 * ```
-                 */
-                toggle: value_1.Value.toggle,
-                /**
-                 * @description Displays a text input field
-                 * @example
-                 * ```
-                  textExample: Value.text({
-                    // required
-                    name: 'Text Example',
-                    required: false,
-                    default: null,
-                 
-                    // optional
-                    description: null,
-                    placeholder: null,
-                    warning: null,
-                    generate: null,
-                    inputmode: 'text',
-                    masked: false,
-                    minLength: null,
-                    maxLength: null,
-                    patterns: [],
-                    immutable: false,
-                  }),
-                 * ```
-                 */
-                text: value_1.Value.text,
-                /**
-                 * @description Displays a large textarea field for long form entry.
-                 * @example
-                 * ```
-                  textareaExample: Value.textarea({
-                    // required
-                    name: 'Textarea Example',
-                    required: false,
-                    default: null,
-                 
-                    // optional
-                    description: null,
-                    placeholder: null,
-                    warning: null,
-                    minLength: null,
-                    maxLength: null,
-                    immutable: false,
-                  }),
-                 * ```
-                 */
-                textarea: value_1.Value.textarea,
-                /**
-                 * @description Displays a number input field
-                 * @example
-                 * ```
-                  numberExample: Value.number({
-                    // required
-                    name: 'Number Example',
-                    required: false,
-                    default: null,
-                    integer: true,
-                 
-                    // optional
-                    description: null,
-                    placeholder: null,
-                    warning: null,
-                    min: null,
-                    max: null,
-                    immutable: false,
-                    step: null,
-                    units: null,
-                  }),
-                 * ```
-                 */
-                number: value_1.Value.number,
-                /**
-                 * @description Displays a browser-native color selector.
-                 * @example
-                 * ```
-                  colorExample: Value.color({
-                    // required
-                    name: 'Color Example',
-                    required: false,
-                    default: null,
-                 
-                    // optional
-                    description: null,
-                    warning: null,
-                    immutable: false,
-                  }),
-                 * ```
-                 */
-                color: value_1.Value.color,
-                /**
-                 * @description Displays a browser-native date/time selector.
-                 * @example
-                 * ```
-                  datetimeExample: Value.datetime({
-                    // required
-                    name: 'Datetime Example',
-                    required: false,
-                    default: null,
-                 
-                    // optional
-                    description: null,
-                    warning: null,
-                    immutable: false,
-                    inputmode: 'datetime-local',
-                    min: null,
-                    max: null,
-                  }),
-                 * ```
-                 */
-                datetime: value_1.Value.datetime,
-                /**
-                 * @description Displays a select modal with radio buttons, allowing for a single selection.
-                 * @example
-                 * ```
-                  selectExample: Value.select({
-                    // required
-                    name: 'Select Example',
-                    default: 'radio1',
-                    values: {
-                      radio1: 'Radio 1',
-                      radio2: 'Radio 2',
-                    },
-                 
-                    // optional
-                    description: null,
-                    warning: null,
-                    immutable: false,
-                    disabled: false,
-                  }),
-                 * ```
-                 */
-                select: value_1.Value.select,
-                /**
-                 * @description Displays a select modal with checkboxes, allowing for multiple selections.
-                 * @example
-                 * ```
-                  multiselectExample: Value.multiselect({
-                    // required
-                    name: 'Multiselect Example',
-                    values: {
-                      option1: 'Option 1',
-                      option2: 'Option 2',
-                    },
-                    default: [],
-                 
-                    // optional
-                    description: null,
-                    warning: null,
-                    immutable: false,
-                    disabled: false,
-                    minlength: null,
-                    maxLength: null,
-                  }),
-                 * ```
-                 */
-                multiselect: value_1.Value.multiselect,
-                /**
-                 * @description Display a collapsable grouping of additional fields, a "sub form". The second value is the inputSpec spec for the sub form.
-                 * @example
-                 * ```
-                  objectExample: Value.object(
-                    {
-                      // required
-                      name: 'Object Example',
-                 
-                      // optional
-                      description: null,
-                      warning: null,
-                    },
-                    InputSpec.of({}),
-                  ),
-                 * ```
-                 */
-                object: value_1.Value.object,
-                /**
-                 * @description Displays a dropdown, allowing for a single selection. Depending on the selection, a different object ("sub form") is presented.
-                 * @example
-                 * ```
-                  unionExample: Value.union(
-                    {
-                      // required
-                      name: 'Union Example',
-                      default: 'option1',
-                 
-                      // optional
-                      description: null,
-                      warning: null,
-                      disabled: false,
-                      immutable: false,
-                    },
-                    Variants.of({
-                      option1: {
-                        name: 'Option 1',
-                        spec: InputSpec.of({}),
-                      },
-                      option2: {
-                        name: 'Option 2',
-                        spec: InputSpec.of({}),
-                      },
+            List: list_1.List,
+            Value: value_1.Value,
+            Variants: variants_1.Variants,
+            plugin: {
+                url: this.ifPluginEnabled('url-v0', {
+                    register: (effects, options) => effects.plugin.url.register({
+                        tableAction: options.tableAction.id,
                     }),
-                  ),
-                 * ```
-                 */
-                union: value_1.Value.union,
-                /**
-                 * @description Presents an interface to add/remove/edit items in a list.
-                 * @example
-                 * In this example, we create a list of text inputs.
-                 *
-                 * ```
-                  listExampleText: Value.list(
-                    List.text(
-                      {
-                        // required
-                        name: 'Text List',
-        
-                        // optional
-                        description: null,
-                        warning: null,
-                        default: [],
-                        minLength: null,
-                        maxLength: null,
-                      },
-                      {
-                        // required
-                        patterns: [],
-        
-                        // optional
-                        placeholder: null,
-                        generate: null,
-                        inputmode: 'url',
-                        masked: false,
-                        minLength: null,
-                        maxLength: null,
-                      },
-                    ),
-                  ),
-                 * ```
-                 * @example
-                 * In this example, we create a list of objects.
-                 *
-                 * ```
-                  listExampleObject: Value.list(
-                    List.obj(
-                      {
-                        // required
-                        name: 'Object List',
-        
-                        // optional
-                        description: null,
-                        warning: null,
-                        default: [],
-                        minLength: null,
-                        maxLength: null,
-                      },
-                      {
-                        // required
-                        spec: InputSpec.of({}),
-        
-                        // optional
-                        displayAs: null,
-                        uniqueBy: null,
-                      },
-                    ),
-                  ),
-                 * ```
-                 */
-                list: value_1.Value.list,
-                hidden: value_1.Value.hidden,
-                dynamicToggle: (value_1.Value.dynamicToggle),
-                dynamicText: (value_1.Value.dynamicText),
-                dynamicTextarea: (value_1.Value.dynamicTextarea),
-                dynamicNumber: (value_1.Value.dynamicNumber),
-                dynamicColor: (value_1.Value.dynamicColor),
-                dynamicDatetime: (value_1.Value.dynamicDatetime),
-                dynamicSelect: (value_1.Value.dynamicSelect),
-                dynamicMultiselect: (value_1.Value.dynamicMultiselect),
-                filteredUnion: (getDisabledFn, a, aVariants) => value_1.Value.filteredUnion(getDisabledFn, a, aVariants),
-                dynamicUnion: (getA, aVariants) => value_1.Value.dynamicUnion(getA, aVariants),
-            },
-            Variants: {
-                of: (a) => variants_1.Variants.of(a),
+                    exportUrl: (effects, options) => effects.plugin.url.exportUrl({
+                        hostnameInfo: options.hostnameInfo,
+                        removeAction: options.removeAction?.id ?? null,
+                        overflowActions: options.overflowActions.map((a) => a.id),
+                    }),
+                    setupExportedUrls: setupExportedUrls_1.setupExportedUrls, // similar to setupInterfaces
+                }),
             },
         };
     }
@@ -931,29 +629,29 @@ class StartSdk {
 exports.StartSdk = StartSdk;
 async function runCommand(effects, image, command, options, name) {
     let commands;
-    if (command instanceof T.UseEntrypoint) {
+    if (T.isUseEntrypoint(command)) {
         const imageMeta = await fs
             .readFile(`/media/startos/images/${image.imageId}.json`, {
-            encoding: "utf8",
+            encoding: 'utf8',
         })
-            .catch(() => "{}")
+            .catch(() => '{}')
             .then(JSON.parse);
         commands = imageMeta.entrypoint ?? [];
-        commands.concat(...(command.overridCmd ?? imageMeta.cmd ?? []));
+        commands = commands.concat(...(command.overridCmd ?? imageMeta.cmd ?? []));
     }
     else
         commands = (0, util_4.splitCommand)(command);
-    return SubContainer_1.SubContainer.with(effects, image, options.mounts, name ||
+    return SubContainer_1.SubContainerOwned.withTemp(effects, image, options.mounts, name ||
         commands
             .map((c) => {
-            if (c.includes(" ")) {
+            if (c.includes(' ')) {
                 return `"${c.replace(/"/g, `\"`)}"`;
             }
             else {
                 return c;
             }
         })
-            .join(" "), async (subcontainer) => {
+            .join(' '), async (subcontainer) => {
         const res = await subcontainer.exec(commands);
         if (res.exitCode || res.exitSignal) {
             throw new SubContainer_1.ExitError(commands[0], res);