@astrale-os/sdk 0.6.0-beta.0 → 0.6.0-beta.1

package/dist/application/view/route.d.ts

@@ -1,6 +1,10 @@
 import { type ViewHostRequirements } from '@astrale-os/kernel-core/schema/kernel/syscalls/view-resolution';
 export type { ViewHostRequirements } from '@astrale-os/kernel-core/schema/kernel/syscalls/view-resolution';
 export type FrontendHandshake = 'shell' | 'none';
+/**
+ * @deprecated Every trusted View receives the Shell's shared browser profile: requirements within
+ * it are redundant, and Astrale hosts refuse any beyond it. Declare none.
+ */
 export interface IframeRequirements {
     readonly sandbox?: readonly string[];
     readonly allow?: readonly string[];
@@ -9,6 +13,10 @@ export type FrontendRouteInput = string | {
     readonly path?: string;
     readonly document?: string;
     readonly handshake?: FrontendHandshake;
+    /**
+     * @deprecated Every trusted View receives the Shell's shared browser profile: requirements
+     * within it are redundant, and Astrale hosts refuse any beyond it. Remove this field.
+     */
     readonly iframe?: IframeRequirements;
     readonly host?: ViewHostRequirements;
 };

package/dist/tooling/cli/deprecations.d.ts

@@ -0,0 +1,9 @@
+import type { FrontendCompilation } from '../../deployment/build/frontend/index.js';
+/**
+ * What a build still declares that the SDK has deprecated, one line each for its author. A View's
+ * iframe requirements change nothing it receives: every trusted View gets the Shell's shared browser
+ * profile, and Astrale hosts refuse requirements beyond it.
+ */
+export declare function deprecationWarnings(build: {
+    readonly frontend?: FrontendCompilation;
+}): readonly string[];

package/dist/tooling/cli/deprecations.js

@@ -0,0 +1,15 @@
+/**
+ * What a build still declares that the SDK has deprecated, one line each for its author. A View's
+ * iframe requirements change nothing it receives: every trusted View gets the Shell's shared browser
+ * profile, and Astrale hosts refuse requirements beyond it.
+ */
+export function deprecationWarnings(build) {
+    return (build.frontend?.routes ?? []).flatMap(({ view, iframe }) => {
+        if (iframe === undefined)
+            return [];
+        const declared = [...(iframe.sandbox ?? []), ...(iframe.allow ?? [])].join(', ');
+        return [
+            `View ${view} declares iframe requirements (${declared}), which are deprecated: every trusted View receives the Shell's shared browser profile, and Astrale hosts refuse requirements beyond it. Remove its \`iframe\` field.`,
+        ];
+    });
+}

package/dist/tooling/cli/development/develop.js

@@ -3,8 +3,9 @@ import { join } from 'node:path';
 import { resolveAstraleInstanceIssuer } from '../astrale/instance.js';
 import { resolveCompatibleAstrale } from '../astrale/version.js';
 import { loadPrivateCredentialFile } from '../credential.js';
+import { deprecationWarnings } from '../deprecations.js';
 import { loadPrivateSecretsFile } from '../dotenv.js';
-import { error, info } from '../log.js';
+import { error, info, warn } from '../log.js';
 import { DevelopmentCandidateBuilder, discoverRuntimePath, sameDeploymentCandidate, sameEnvironment, } from './candidate.js';
 import { deployDevelopmentCandidate } from './deployment.js';
 import { DevelopmentLifecycle } from './lifecycle.js';
@@ -59,6 +60,8 @@ export async function develop(input) {
             throw new TypeError('--session-file requires an Environment installation that is active for this development session.');
         }
         info(`Domain: ${current.artifact.build.schema.compiled.root.origin}`);
+        for (const warning of deprecationWarnings(current.artifact.build))
+            warn(warning);
         if (current.installation !== undefined && !input.deployOnly) {
             installationExecutable = await resolveCompatibleAstrale({
                 projectDir: input.projectDir,

package/dist/tooling/cli/orchestrate.js

@@ -5,11 +5,12 @@ import { packageDomain } from '../packaging/index.js';
 import { parseArgs } from './arguments.js';
 import { resolveCompatibleAstrale } from './astrale/version.js';
 import { BunRequiredError } from './bun.js';
+import { deprecationWarnings } from './deprecations.js';
 import { develop } from './development/develop.js';
 import { loadDeclaredSecrets } from './dotenv.js';
 import { reconcileEnvironmentRelease } from './environment-release.js';
 import { ERROR_USAGE, helpRequest, helpText } from './help.js';
-import { error, info } from './log.js';
+import { error, info, warn } from './log.js';
 import { importModule, loadProject, runtimeEntrypoint, selectEnvironment } from './project.js';
 import { executeTests } from './test.js';
 const CONFIG_NAMES = ['astrale.config.ts', 'astrale.config.js', 'astrale.config.mjs'];
@@ -67,6 +68,8 @@ export async function run(argv) {
         });
     }
     const build = compile(project.application);
+    for (const warning of deprecationWarnings(build))
+        warn(warning);
     const resolved = await resolveRuntime(runtimeEntrypoint(project), (path) => importModule(resolve(dirname(configPath), path)));
     admitRuntime({ runtime: build.runtime }, resolved);
     if (parsed.command === 'build') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/sdk",
-  "version": "0.6.0-beta.0",
+  "version": "0.6.0-beta.1",
   "description": "Schema-first SDK for defining, composing, and deploying Astrale domains",
   "keywords": [
     "astrale",