@forgeax/engine-import 0.1.4 → 0.1.7

package/dist/scriptable-pack-host.d.ts

@@ -3,7 +3,8 @@ import { type NativeCooker } from '@forgeax/engine-pack/native-cooker';
 import type { ScanSourceDeclaration } from '@forgeax/engine-pack/scanner';
 import { type ScriptablePackDefinition, type ScriptablePackSourceClosureEntry } from '@forgeax/engine-pack/source';
 import type { AssetGuid as AssetGuidType, AssetPublicationEnvelope, AssetPublicationOutput, ResourceRevision, Result } from '@forgeax/engine-types';
-import type { DdcPack } from './import-runner.js';
+import type { DdcPack, ImportRunnerFs } from './import-runner.js';
+import type { ImporterRegistry } from './importer-registry.js';
 import type { ScriptablePackDomainError, ScriptablePackStagedOutput } from './scriptable-pack.js';
 import { type ScriptableSourcePackageProduct, type ScriptableSourcePackageResult } from './scriptable-source-package.js';
 type FinalizedPackageTransport = Awaited<ReturnType<typeof finalizePackageTransportSource>>;
@@ -48,12 +49,19 @@ export interface AuthoredPackTransport {
     readonly cooked?: CookedAuthoredPack;
     readonly finalized?: FinalizedPackageTransport;
 }
+/** Build-time capabilities required to expose ordinary Meta products to a ScriptablePack. */
+export interface ScriptablePackExternalImportOptions {
+    readonly importerRegistry: ImporterRegistry;
+    readonly fsForImport: ImportRunnerFs;
+    /** Package path aliases from forgeax.assets.paths; defaults to the current project config. */
+    readonly assetPaths?: Readonly<Record<string, string>>;
+}
 export declare function canonicalScriptableSourcePath(sourcePath: string): string;
 export declare function scriptablePackInputs(sourcePaths: readonly string[], declarations: ReadonlyMap<string, ScanSourceDeclaration>, cwd: string, generationFor: (displaySourcePath: string) => number, policyFor: (displaySourcePath: string) => ScriptablePackTransportPolicy): ScriptablePackInput[];
 /** Materialize one accepted ScriptablePack without duplicating dev/build loops. */
 export declare function materializePreparedScriptablePack(prepared: PreparedScriptablePack, paths: ScriptablePackTransportPaths, sink: ScriptablePackTransportSink): Promise<ReadonlyMap<string, string>>;
 export declare function readCookedAuthoredPack(authoredPack: AuthoredPackInput, cookers?: readonly NativeCooker[], sourcePath?: string): Promise<CookedAuthoredPack | undefined>;
-export declare function declaredPackExternalOutputs(declarations: ReadonlyMap<string, ScanSourceDeclaration>, cookers?: readonly NativeCooker[], requiredGuids?: readonly AssetGuidType[]): Promise<readonly ScriptablePackStagedOutput[]>;
+export declare function declaredPackExternalOutputs(declarations: ReadonlyMap<string, ScanSourceDeclaration>, cookers?: readonly NativeCooker[], requiredGuids?: readonly AssetGuidType[], externalImport?: ScriptablePackExternalImportOptions): Promise<readonly ScriptablePackStagedOutput[]>;
 /** Normalize one authored Pack and, when needed, run its registered cooker once. */
 export declare function prepareAuthoredPackTransport(authoredPack: AuthoredPackInput, cookers: readonly NativeCooker[] | undefined, policyFor: (guid: string) => PackageFinalizePolicy, sourcePath?: string): Promise<AuthoredPackTransport>;
 /** Project one produced ScriptablePack into the publication tuple shared by dev and build. */

package/dist/scriptable-pack-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scriptable-pack-host.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-host.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scriptable-pack-host.d.ts","sourceRoot":"","sources":["../src/scriptable-pack-host.ts"],"names":[],"mappings":"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"}

package/dist/source-package-publication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-package-publication.d.ts","sourceRoot":"","sources":["../src/source-package-publication.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source-package-publication.d.ts","sourceRoot":"","sources":["../src/source-package-publication.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-import",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -27,12 +27,12 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-ddc": "0.1.4",
-    "@forgeax/engine-ecs": "0.1.4",
-    "@forgeax/engine-geometry": "0.1.4",
-    "@forgeax/engine-pack": "0.1.4",
-    "@forgeax/engine-scene": "0.1.4",
-    "@forgeax/engine-types": "0.1.4",
+    "@forgeax/engine-ddc": "0.1.7",
+    "@forgeax/engine-ecs": "0.1.7",
+    "@forgeax/engine-geometry": "0.1.7",
+    "@forgeax/engine-pack": "0.1.7",
+    "@forgeax/engine-scene": "0.1.7",
+    "@forgeax/engine-types": "0.1.7",
     "@noble/hashes": "^2.2.0"
   },
   "devDependencies": {

package/src/__tests__/scriptable-pack-host.unit.test.ts

@@ -0,0 +1,86 @@
+import { AssetGuid } from '@forgeax/engine-pack/guid';
+import type { ScanSourceDeclaration } from '@forgeax/engine-pack/scanner';
+import type {
+  Asset,
+  AssetGuid as AssetGuidType,
+  ImportContext,
+  Importer,
+} from '@forgeax/engine-types';
+import { describe, expect, it } from 'vitest';
+import { ImporterRegistry } from '../importer-registry.js';
+import { declaredPackExternalOutputs } from '../scriptable-pack-host.js';
+
+const GUID = '019ffa97-0000-7000-8000-000000000001';
+
+function parseGuid(value: string): AssetGuidType {
+  const parsed = AssetGuid.parse(value);
+  if (!parsed.ok) throw parsed.error;
+  return parsed.value;
+}
+
+describe('ScriptablePack external Meta staging', () => {
+  it('imports ordinary Meta dependencies into the current staged generation', async () => {
+    const importer: Importer = {
+      key: 'fixture',
+      import: async (ctx: ImportContext) => ({
+        ok: true,
+        value: {
+          assets: [
+            {
+              guid: ctx.subAssets[0]?.guid ?? GUID,
+              kind: 'mesh',
+              payload: {
+                kind: 'mesh',
+                vertices: new Float32Array([0, 1, 2]),
+                attributes: {},
+                submeshes: [],
+                materialSlots: [],
+              } satisfies Asset,
+              refs: [],
+              artifacts: {},
+            },
+          ],
+          sourceDependencies: [],
+        },
+      }),
+    };
+    const registry = new ImporterRegistry();
+    registry.register(importer);
+    const declaration = {
+      format: 'meta.json',
+      sourcePath: '/project/assets/model.bin.meta.json',
+      sourceRevision: 'sha256:meta',
+      value: {
+        schemaVersion: '1.0.0',
+        kind: 'external-asset-package',
+        importer: 'fixture',
+        source: 'model.bin',
+        importSettings: {},
+        subAssets: [{ guid: GUID, sourceIndex: 0, kind: 'mesh' }],
+      },
+    } satisfies Extract<ScanSourceDeclaration, { readonly format: 'meta.json' }>;
+
+    const outputs = await declaredPackExternalOutputs(
+      new Map([[declaration.sourcePath, declaration]]),
+      [],
+      [parseGuid(GUID)],
+      {
+        importerRegistry: registry,
+        fsForImport: {
+          readSource: async () => ({ ok: true as const, value: new Uint8Array([1, 2, 3]) }),
+        },
+        assetPaths: {},
+      },
+    );
+
+    expect(outputs).toHaveLength(1);
+    const output = outputs[0];
+    expect(output).toBeDefined();
+    if (output === undefined) return;
+    expect(AssetGuid.format(output.guid)).toBe(GUID);
+    expect(output.asset).toMatchObject({ kind: 'mesh' });
+    expect(Array.from((output.asset as Asset & { vertices: Float32Array }).vertices)).toEqual([
+      0, 1, 2,
+    ]);
+  });
+});

package/src/__tests__/source-package-publication.integration.test.ts

@@ -0,0 +1,75 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import {
+  commitImportPublication,
+  discardImportPublication,
+  type ImportPublicationInput,
+  stageImportPublication,
+} from '../source-package-publication.js';
+
+const GUID = '019e3969-1d48-7c3b-ac24-6d68f457065f';
+const KEY = 'a'.repeat(64);
+
+function input(root: string, desiredKey = KEY): ImportPublicationInput {
+  return {
+    root,
+    guid: GUID,
+    desiredKey,
+    pack: {
+      schemaVersion: '2.0.0',
+      assets: [{ guid: GUID, kind: 'fixture', payload: { value: 'same' }, refs: [] }],
+    },
+    previousCatalog: [],
+    nextCatalog: [],
+    publishedGuids: [GUID],
+  };
+}
+
+describe('source package publication concurrency', () => {
+  const roots: string[] = [];
+
+  afterEach(async () => {
+    await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+  });
+
+  it('waits for an equivalent newer owner after a strict stale commit', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-source-publication-'));
+    roots.push(root);
+    const publicationInput = input(root);
+    const first = await stageImportPublication(publicationInput);
+    const second = await stageImportPublication(publicationInput);
+    expect(first.ok).toBe(true);
+    expect(second.ok).toBe(true);
+    if (!first.ok || !second.ok) return;
+
+    const winner = (async () => {
+      await new Promise((resolve) => setTimeout(resolve, 40));
+      return commitImportPublication(second.candidate);
+    })();
+    const loser = await commitImportPublication(first.candidate);
+    const winnerResult = await winner;
+
+    expect(loser).toMatchObject({ ok: true, head: { state: 'current', currentKey: KEY } });
+    expect(winnerResult).toMatchObject({ ok: true, head: { state: 'current', currentKey: KEY } });
+  });
+
+  it('keeps a stale publication with a different desired key fail-closed', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-source-publication-'));
+    roots.push(root);
+    const first = await stageImportPublication(input(root, 'a'.repeat(64)));
+    const second = await stageImportPublication(input(root, 'b'.repeat(64)));
+    expect(first.ok).toBe(true);
+    expect(second.ok).toBe(true);
+    if (!first.ok || !second.ok) return;
+
+    const result = await commitImportPublication(first.candidate);
+    await discardImportPublication(second.candidate);
+
+    expect(result).toMatchObject({
+      ok: false,
+      error: { code: 'source-package-ddc-failed', detail: 'DDC lifecycle commit returned stale' },
+    });
+  });
+});

package/src/build-production.ts

@@ -3,6 +3,7 @@ import {
   type CatalogBuildResult,
   createRuntimePackPublication,
   finalizePackageTransportSource,
+  loadAssetConfig,
   metaPathForGuid,
   projectCookedPackageEntry,
 } from '@forgeax/engine-pack/build';
@@ -130,6 +131,11 @@ async function buildAuthoredPackages(
       context.inventory.sourceDeclarations,
       context.cookers,
       inputs.flatMap((input) => Object.values(input.definition.externalAssets)),
+      {
+        importerRegistry: context.importerRegistry,
+        fsForImport: context.fsForImport,
+        assetPaths: loadAssetConfig(context.cwd).paths,
+      },
     ),
   );
   if (!preparedResult.ok) throw context.fail(preparedResult.error);

package/src/index.ts

@@ -113,6 +113,7 @@ export {
   produceScriptablePackProducts,
   projectScriptablePackPublication,
   readCookedAuthoredPack,
+  type ScriptablePackExternalImportOptions,
   type ScriptablePackInput,
   type ScriptablePackPublicationFacts,
   type ScriptablePackTransportPaths,

package/src/scriptable-pack-host.ts

@@ -5,7 +5,9 @@ import { createAcceptedPublication } from '@forgeax/engine-ddc';
 import {
   type AuthoredPackInput,
   finalizePackageTransportSource,
+  loadAssetConfig,
   type PackageFinalizePolicy,
+  resolveAssetSource,
   upgradeLegacyAuthoredPack,
 } from '@forgeax/engine-pack/build';
 import { AssetGuid } from '@forgeax/engine-pack/guid';
@@ -25,8 +27,9 @@ import type {
   ResourceRevision,
   Result,
 } from '@forgeax/engine-types';
-import { err, ok } from '@forgeax/engine-types';
-import type { DdcPack } from './import-runner.js';
+import { AssetError, err, ok } from '@forgeax/engine-types';
+import type { DdcPack, ImportRunnerFs, RunImportMeta } from './import-runner.js';
+import type { ImporterRegistry } from './importer-registry.js';
 import { projectImportProductForBuild } from './pack-projection.js';
 import type { ScriptablePackDomainError, ScriptablePackStagedOutput } from './scriptable-pack.js';
 import { createStandardAssetOutputProducerRegistry } from './scriptable-pack-output-producers.js';
@@ -39,6 +42,7 @@ import {
   type ScriptableSourcePackageProduct,
   type ScriptableSourcePackageResult,
 } from './scriptable-source-package.js';
+import { produceSourcePackage } from './source-package.js';
 
 type FinalizedPackageTransport = Awaited<ReturnType<typeof finalizePackageTransportSource>>;
 
@@ -95,6 +99,14 @@ export interface AuthoredPackTransport {
   readonly finalized?: FinalizedPackageTransport;
 }
 
+/** Build-time capabilities required to expose ordinary Meta products to a ScriptablePack. */
+export interface ScriptablePackExternalImportOptions {
+  readonly importerRegistry: ImporterRegistry;
+  readonly fsForImport: ImportRunnerFs;
+  /** Package path aliases from forgeax.assets.paths; defaults to the current project config. */
+  readonly assetPaths?: Readonly<Record<string, string>>;
+}
+
 export function canonicalScriptableSourcePath(sourcePath: string): string {
   const normalized = sourcePath.replaceAll('\\', '/');
   const marker = '/assets/';
@@ -223,11 +235,82 @@ export async function declaredPackExternalOutputs(
   declarations: ReadonlyMap<string, ScanSourceDeclaration>,
   cookers: readonly NativeCooker[] = [],
   requiredGuids: readonly AssetGuidType[] = [],
+  externalImport?: ScriptablePackExternalImportOptions,
 ): Promise<readonly ScriptablePackStagedOutput[]> {
   if (requiredGuids.length === 0) return [];
   const required = new Set(requiredGuids.map((guid) => AssetGuid.format(guid).toLowerCase()));
   const outputs: ScriptablePackStagedOutput[] = [];
   for (const declaration of declarations.values()) {
+    if (declaration.format === 'meta.json') {
+      if (externalImport === undefined) continue;
+      if (!declaration.value.subAssets.some((asset) => required.has(asset.guid.toLowerCase()))) {
+        continue;
+      }
+      const assetPaths = externalImport.assetPaths ?? loadAssetConfig(process.cwd()).paths;
+      const resolved = resolveAssetSource(
+        declaration.sourcePath,
+        declaration.value.source,
+        assetPaths,
+      );
+      if (!resolved.ok) {
+        throw new AssetError({
+          code: 'asset-not-imported',
+          expected: `a resolvable source for Meta dependency ${declaration.sourcePath}`,
+          hint: 'repair the Meta source path before rebuilding the ScriptablePack',
+        });
+      }
+      const meta: RunImportMeta = {
+        importer: declaration.value.importer,
+        source: resolved.value,
+        sourceRevision: declaration.sourceRevision,
+        ...(declaration.value.packageId === undefined
+          ? {}
+          : { packageId: declaration.value.packageId }),
+        ...(declaration.value.provenance === undefined
+          ? {}
+          : { provenance: declaration.value.provenance }),
+        ...(declaration.value.revision === undefined
+          ? {}
+          : { revision: declaration.value.revision }),
+        ...(declaration.value.diagnostics === undefined
+          ? {}
+          : { diagnostics: declaration.value.diagnostics }),
+        importSettings: declaration.value.importSettings,
+        ...(declaration.value.sourceOverrides === undefined
+          ? {}
+          : { sourceOverrides: declaration.value.sourceOverrides }),
+        subAssets: declaration.value.subAssets.map(({ guid, sourceIndex, sourceKey, kind }) => ({
+          guid,
+          sourceIndex,
+          ...(sourceKey === undefined ? {} : { sourceKey }),
+          kind,
+        })),
+        buildPack: false,
+      };
+      const sourcePackage = await produceSourcePackage({
+        meta,
+        registry: externalImport.importerRegistry,
+        fs: externalImport.fsForImport,
+      });
+      if (!sourcePackage.ok) {
+        throw new AssetError({
+          code: 'asset-not-imported',
+          expected: `the ${declaration.value.importer} importer to produce Meta dependency outputs`,
+          hint: `repair ${declaration.sourcePath} before rebuilding the ScriptablePack`,
+        });
+      }
+      for (const asset of sourcePackage.value.product.assets) {
+        const key = asset.guid.toLowerCase();
+        if (!required.has(key)) continue;
+        const parsed = AssetGuid.parse(asset.guid);
+        if (!parsed.ok) throw parsed.error;
+        outputs.push({
+          guid: parsed.value,
+          asset: { kind: asset.kind, ...(asset.payload as Record<string, unknown>) } as Asset,
+        });
+      }
+      continue;
+    }
     if (declaration.format !== 'pack.json') continue;
     const declaredAssets = declaration.value.assets.filter((asset) =>
       required.has(asset.guid.toLowerCase()),

package/src/source-package-publication.ts

@@ -83,6 +83,33 @@ function inspectHead(root: string, guid: string, desiredKey: string): Promise<Dd
   return new DdcLifecycle(root).inspect(guid, desiredKey);
 }
 
+const PUBLICATION_SETTLE_TIMEOUT_MS = 5_000;
+const PUBLICATION_SETTLE_POLL_MS = 10;
+
+async function inspectAfterSupersededCommit(candidate: StagedSourcePackageDdc): Promise<DdcHead> {
+  let head = await inspectHead(candidate.root, candidate.lease.guid, candidate.lease.desiredKey);
+  if (head.state === 'current' && head.currentKey === candidate.lease.desiredKey) return head;
+
+  // A newer owner may already have superseded this lease while it is still
+  // cooking.  The strict DDC CAS correctly returns `stale` to this candidate;
+  // wait for that owner to publish before turning an equivalent publication
+  // into a user-visible import failure.  The wait is bounded so a crashed
+  // owner never leaves the caller hanging and a different desired key still
+  // fails closed.
+  const deadline = Date.now() + PUBLICATION_SETTLE_TIMEOUT_MS;
+  while (
+    Date.now() < deadline &&
+    head.activeLease !== undefined &&
+    head.activeLease.attempt !== candidate.lease.attempt &&
+    head.activeLease.desiredKey === candidate.lease.desiredKey
+  ) {
+    await new Promise((resolve) => setTimeout(resolve, PUBLICATION_SETTLE_POLL_MS));
+    head = await inspectHead(candidate.root, candidate.lease.guid, candidate.lease.desiredKey);
+    if (head.state === 'current' && head.currentKey === candidate.lease.desiredKey) return head;
+  }
+  return head;
+}
+
 async function stageSourcePackageDdc(
   input: SourcePackageDdcEntryInput,
 ): Promise<Result<StagedSourcePackageDdc, SourcePackageError>> {
@@ -106,6 +133,10 @@ async function commitSourcePackageDdc(
   try {
     const commit = await candidate.session.commitEntry(candidate, candidate.lease.desiredKey);
     if (commit.result !== 'current') {
+      const head = await inspectAfterSupersededCommit(candidate);
+      if (head.state === 'current' && head.currentKey === candidate.lease.desiredKey) {
+        return ok(head);
+      }
       return err(
         sourcePackageError('source-package-ddc-failed', candidate.context, {
           stage: 'ddc',