@jskit-ai/kernel 0.1.244 → 0.1.246

package/server/support/shellOutlets.test.js

@@ -1,336 +0,0 @@
-import assert from "node:assert/strict";
-import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { tmpdir } from "node:os";
-import test from "node:test";
-import {
-  discoverShellOutletSourcePathsFromApp,
-  discoverShellOutletTargetsFromApp,
-  resolveShellOutletPlacementTargetFromApp
-} from "./shellOutlets.js";
-
-async function withTempApp(run) {
-  const appRoot = await mkdtemp(path.join(tmpdir(), "kernel-shell-outlets-"));
-  try {
-    return await run(appRoot);
-  } finally {
-    await rm(appRoot, { recursive: true, force: true });
-  }
-}
-
-async function writeFileInApp(appRoot, relativePath, source) {
-  const absoluteFilePath = path.join(appRoot, relativePath);
-  await mkdir(path.dirname(absoluteFilePath), { recursive: true });
-  await writeFile(absoluteFilePath, source, "utf8");
-}
-
-test("resolveShellOutletPlacementTargetFromApp reads outlets across app Vue files", async () => {
-  await withTempApp(async (appRoot) => {
-    await writeFileInApp(
-      appRoot,
-      "src/components/ShellLayout.vue",
-      `<template>
-  <div>
-    <ShellOutlet target="shell-layout:primary-menu" />
-    <ShellOutlet target="shell-layout:top-right" />
-  </div>
-</template>
-`
-    );
-    await writeFileInApp(
-      appRoot,
-      "src/pages/admin/workspace/settings/index.vue",
-      `<template>
-  <section>
-    <ShellOutlet target="admin-settings:forms" default />
-  </section>
-</template>
-`
-    );
-
-    const target = await resolveShellOutletPlacementTargetFromApp({
-      appRoot,
-      context: "ui-generator"
-    });
-
-    assert.equal(target.id, "admin-settings:forms");
-  });
-});
-
-test("discoverShellOutletTargetsFromApp includes installed package placement outlets", async () => {
-  await withTempApp(async (appRoot) => {
-    await writeFileInApp(
-      appRoot,
-      "src/components/ShellLayout.vue",
-      `<template>
-  <div>
-    <ShellOutlet target="shell-layout:primary-menu" default />
-  </div>
-</template>
-`
-    );
-    await writeFileInApp(
-      appRoot,
-      "package.json",
-      `${JSON.stringify(
-        {
-          name: "fixture-app",
-          private: true,
-          dependencies: {
-            "@example/users-web": "1.0.0"
-          }
-        },
-        null,
-        2
-      )}\n`
-    );
-    await writeFileInApp(
-      appRoot,
-      "node_modules/@example/users-web/package.json",
-      `${JSON.stringify({
-        name: "@example/users-web",
-        version: "1.0.0",
-        jskit: {
-          metadata: {
-            ui: {
-              placements: {
-                outlets: [
-                  {
-                    target: "admin-cog:primary-menu",
-                    source: "src/client/components/UsersWorkspaceToolsWidget.vue"
-                  }
-                ]
-              }
-            }
-          }
-        }
-      }, null, 2)}\n`
-    );
-
-    const discovered = await discoverShellOutletTargetsFromApp({ appRoot });
-    assert.deepEqual(
-      discovered.targets.map((entry) => entry.id),
-      ["admin-cog:primary-menu", "shell-layout:primary-menu"]
-    );
-    assert.deepEqual(discovered.targets[0], {
-      id: "admin-cog:primary-menu",
-      default: false,
-      sourcePath: "package:@example/users-web:src/client/components/UsersWorkspaceToolsWidget.vue",
-      sourcePackageId: "@example/users-web"
-    });
-
-    const target = await resolveShellOutletPlacementTargetFromApp({
-      appRoot,
-      placement: "admin-cog:primary-menu",
-      context: "ui-generator"
-    });
-    assert.equal(target.id, "admin-cog:primary-menu");
-  });
-});
-
-test("discoverShellOutletTargetsFromApp returns targets with sourcePath and default marker", async () => {
-  await withTempApp(async (appRoot) => {
-    await writeFileInApp(
-      appRoot,
-      "src/components/ShellLayout.vue",
-      `<template>
-  <div>
-    <ShellOutlet target="shell-layout:primary-menu" />
-  </div>
-</template>
-`
-    );
-    await writeFileInApp(
-      appRoot,
-      "src/pages/admin/toolbox/index.vue",
-      `<template>
-  <section>
-    <ShellOutlet target="admin-toolbox:widgets" default />
-  </section>
-</template>
-`
-    );
-
-    const discovered = await discoverShellOutletTargetsFromApp({ appRoot });
-    assert.equal(discovered.defaultTargetId, "admin-toolbox:widgets");
-    assert.deepEqual(discovered.targets, [
-      {
-        id: "admin-toolbox:widgets",
-        default: true,
-        sourcePath: "src/pages/admin/toolbox/index.vue"
-      },
-      {
-        id: "shell-layout:primary-menu",
-        default: false,
-        sourcePath: "src/components/ShellLayout.vue"
-      }
-    ]);
-  });
-});
-
-test("discoverShellOutletTargetsFromApp discovers route meta placement outlets", async () => {
-  await withTempApp(async (appRoot) => {
-    await writeFileInApp(
-      appRoot,
-      "src/pages/w/[workspaceSlug]/admin/contacts/[contactId]/contact-tools.vue",
-      `<template><section /></template>
-
-<route lang="json">
-{
-  "meta": {
-    "jskit": {
-      "placements": {
-        "outlets": [
-          {
-            "target": "contact-tools:sub-pages"
-          }
-        ]
-      }
-    }
-  }
-}
-</route>
-`
-    );
-
-    const discovered = await discoverShellOutletTargetsFromApp({ appRoot });
-    assert.deepEqual(discovered.targets, [
-      {
-        id: "contact-tools:sub-pages",
-        default: false,
-        sourcePath: "src/pages/w/[workspaceSlug]/admin/contacts/[contactId]/contact-tools.vue"
-      }
-    ]);
-
-    const target = await resolveShellOutletPlacementTargetFromApp({
-      appRoot,
-      placement: "contact-tools:sub-pages",
-      context: "ui-generator"
-    });
-    assert.equal(target.id, "contact-tools:sub-pages");
-  });
-});
-
-test("resolveShellOutletPlacementTargetFromApp supports explicit placement override", async () => {
-  await withTempApp(async (appRoot) => {
-    await writeFileInApp(
-      appRoot,
-      "src/components/ShellLayout.vue",
-      `<template>
-  <div>
-    <ShellOutlet target="shell-layout:primary-menu" default />
-    <ShellOutlet target="shell-layout:top-right" />
-  </div>
-</template>
-`
-    );
-
-    const target = await resolveShellOutletPlacementTargetFromApp({
-      appRoot,
-      context: "ui-generator",
-      placement: "shell-layout:top-right"
-    });
-
-    assert.equal(target.id, "shell-layout:top-right");
-  });
-});
-
-test("resolveShellOutletPlacementTargetFromApp validates placement format", async () => {
-  await withTempApp(async (appRoot) => {
-    await writeFileInApp(
-      appRoot,
-      "src/components/ShellLayout.vue",
-      `<template>
-  <div>
-    <ShellOutlet target="shell-layout:primary-menu" default />
-  </div>
-</template>
-`
-    );
-
-    await assert.rejects(
-      () =>
-        resolveShellOutletPlacementTargetFromApp({
-          appRoot,
-          context: "ui-generator",
-          placement: "invalid-placement"
-        }),
-      /option "placement" must be a target in "host:position" format/
-    );
-  });
-});
-
-test("resolveShellOutletPlacementTargetFromApp throws when multiple default outlets exist", async () => {
-  await withTempApp(async (appRoot) => {
-    await writeFileInApp(
-      appRoot,
-      "src/components/ShellLayout.vue",
-      `<template>
-  <div>
-    <ShellOutlet target="shell-layout:primary-menu" default />
-  </div>
-</template>
-`
-    );
-    await writeFileInApp(
-      appRoot,
-      "src/pages/admin/workspace/settings/index.vue",
-      `<template>
-  <section>
-    <ShellOutlet target="admin-settings:forms" default />
-  </section>
-</template>
-`
-    );
-
-    await assert.rejects(
-      () =>
-        resolveShellOutletPlacementTargetFromApp({
-          appRoot,
-          context: "ui-generator"
-        }),
-      /Multiple default ShellOutlet targets found in app source/
-    );
-  });
-});
-
-test("discoverShellOutletSourcePathsFromApp ignores default conflicts while keeping source paths", async () => {
-  await withTempApp(async (appRoot) => {
-    await writeFileInApp(
-      appRoot,
-      "src/components/ShellLayout.vue",
-      `<template>
-  <div>
-    <ShellOutlet target="shell-layout:primary-menu" default />
-    <ShellOutlet target="shell-layout:primary-bottom-nav" default />
-  </div>
-</template>
-`
-    );
-
-    const discovered = await discoverShellOutletSourcePathsFromApp({ appRoot });
-    assert.deepEqual(discovered.targets, [
-      {
-        id: "shell-layout:primary-bottom-nav",
-        default: true,
-        sourcePath: "src/components/ShellLayout.vue"
-      },
-      {
-        id: "shell-layout:primary-menu",
-        default: true,
-        sourcePath: "src/components/ShellLayout.vue"
-      }
-    ]);
-  });
-});
-
-test("resolveShellOutletPlacementTargetFromApp requires appRoot", async () => {
-  await assert.rejects(
-    () =>
-      resolveShellOutletPlacementTargetFromApp({
-        appRoot: "",
-        context: "ui-generator"
-      }),
-    /requires appRoot/
-  );
-});

package/server/surface/index.js

@@ -1,18 +0,0 @@
-export { createSurfaceRegistry, normalizeSurfaceId } from "../../shared/surface/registry.js";
-export { createSurfacePathHelpers } from "../../shared/surface/paths.js";
-export { createSurfaceRuntime, filterRoutesBySurface } from "../../shared/surface/runtime.js";
-export { escapeRegExp } from "../../shared/surface/escapeRegExp.js";
-export {
-  API_BASE_PATH,
-  API_PREFIX,
-  API_PREFIX_SLASH,
-  API_DOCS_PATH,
-  API_REALTIME_PATH,
-  normalizePathname,
-  isApiPath,
-  isVersionedApiPath,
-  toVersionedApiPath,
-  toVersionedApiPrefix,
-  buildVersionedApiPath,
-  isVersionedApiPrefixMatch
-} from "../../shared/surface/apiPaths.js";

package/shared/actions/audit.js

@@ -1,7 +0,0 @@
-function createNoopAuditAdapter() {
-  return {
-    async emitExecution() {}
-  };
-}
-
-export { createNoopAuditAdapter };

package/shared/actions/idempotency.js

@@ -1,62 +0,0 @@
-import { createActionRuntimeError } from "./actionDefinitions.js";
-import { normalizeText } from "./textNormalization.js";
-
-function resolveRequestIdempotencyKey(context) {
-  return normalizeText(context?.requestMeta?.idempotencyKey || context?.requestMeta?.commandId || "");
-}
-
-function resolveActionIdempotencyKey(definition, context) {
-  const policy = normalizeText(definition?.idempotency || "none").toLowerCase();
-  if (policy === "none") {
-    return "";
-  }
-
-  return resolveRequestIdempotencyKey(context);
-}
-
-function createNoopIdempotencyAdapter() {
-  return {
-    async claimOrReplay() {
-      return {
-        type: "proceed",
-        idempotencyReplay: false,
-        claim: null,
-        replayResult: null
-      };
-    },
-    async markSucceeded() {},
-    async markFailed() {}
-  };
-}
-
-function ensureIdempotencyKeyIfRequired(definition, context, key) {
-  const policy = normalizeText(definition?.idempotency || "none").toLowerCase();
-  if (policy !== "required") {
-    return;
-  }
-
-  if (normalizeText(key)) {
-    return;
-  }
-
-  throw createActionRuntimeError(400, "Validation failed.", {
-    code: "ACTION_IDEMPOTENCY_KEY_REQUIRED",
-    details: {
-      fieldErrors: {
-        idempotencyKey: "Idempotency key is required for this action."
-      }
-    }
-  });
-}
-
-const __testables = {
-  normalizeText,
-  resolveRequestIdempotencyKey
-};
-
-export {
-  resolveActionIdempotencyKey,
-  ensureIdempotencyKeyIfRequired,
-  createNoopIdempotencyAdapter,
-  __testables
-};

package/shared/actions/observability.js

@@ -1,10 +0,0 @@
-function createNoopObservabilityAdapter() {
-  return {
-    recordExecutionStart() {},
-    recordExecutionFinish() {},
-    recordValidationFailure() {},
-    recordIdempotentReplay() {}
-  };
-}
-
-export { createNoopObservabilityAdapter };