@alistigo/artifact-core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mikael Labrut
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/auth.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @experimental
+ * Placeholder for future auth plugin extension point.
+ * No implementation ships in P0 — typed stub for forward compatibility.
+ */
+export interface AuthPlugin {
+    readonly type: "auth";
+    getToken(): Promise<string | undefined>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC"}

package/dist/auth.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":""}

package/dist/error-boundary.d.ts

@@ -0,0 +1,17 @@
+import { Component, type ErrorInfo, type ReactNode } from "react";
+export interface ArtifactErrorBoundaryProps {
+    onError: (error: Error, componentStack: string | undefined) => void;
+    children?: ReactNode;
+}
+interface State {
+    hasError: boolean;
+    error?: Error;
+}
+export declare class ArtifactErrorBoundary extends Component<ArtifactErrorBoundaryProps, State> {
+    state: State;
+    static getDerivedStateFromError(error: unknown): State;
+    componentDidCatch(error: unknown, errorInfo: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../src/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElE,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACpE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,UAAU,KAAK;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,0BAA0B,EAAE,KAAK,CAAC;IAC5E,KAAK,EAAE,KAAK,CAAuB;IAE5C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;IAI7C,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAK7D,MAAM,IAAI,SAAS;CAM7B"}

package/dist/error-boundary.js

@@ -0,0 +1,18 @@
+import { Component } from "react";
+export class ArtifactErrorBoundary extends Component {
+    state = { hasError: false };
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error: error instanceof Error ? error : new Error(String(error)) };
+    }
+    componentDidCatch(error, errorInfo) {
+        const wrapped = error instanceof Error ? error : new Error(String(error));
+        this.props.onError(wrapped, errorInfo.componentStack ?? undefined);
+    }
+    render() {
+        if (this.state.hasError) {
+            return null;
+        }
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=error-boundary.js.map

package/dist/error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.js","sourceRoot":"","sources":["../src/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkC,MAAM,OAAO,CAAC;AAYlE,MAAM,OAAO,qBAAsB,SAAQ,SAA4C;IAC5E,KAAK,GAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAE5C,MAAM,CAAC,wBAAwB,CAAC,KAAc;QAC5C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IAC9F,CAAC;IAEQ,iBAAiB,CAAC,KAAc,EAAE,SAAoB;QAC7D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,cAAc,IAAI,SAAS,CAAC,CAAC;IACrE,CAAC;IAEQ,MAAM;QACb,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { AlistigoPlugin, PluginHostInfo, PluginLogger, PluginRuntime, } from "@alistigo/artifact-plugin-api";
+export { createPluginRuntime } from "@alistigo/artifact-plugin-api";
+export { createLogger } from "@alistigo/logger";
+export type { AuthPlugin } from "./auth.js";
+export type { ArtifactErrorBoundaryProps } from "./error-boundary.js";
+export { ArtifactErrorBoundary } from "./error-boundary.js";
+export type { ArtifactLifecycle, StartArtifactConfig } from "./lifecycle.js";
+export { useArtifactLifecycle, useArtifactPhase, useStartArtifact } from "./lifecycle.js";
+export type { ArtifactPhase } from "./phase.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,GACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC1F,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createPluginRuntime } from "@alistigo/artifact-plugin-api";
+export { createLogger } from "@alistigo/logger";
+export { ArtifactErrorBoundary } from "./error-boundary.js";
+export { useArtifactLifecycle, useArtifactPhase, useStartArtifact } from "./lifecycle.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,14 @@
+import type { ArtifactPhase } from "./phase.js";
+export interface ArtifactLifecycle {
+    phase: ArtifactPhase;
+    error: Error | undefined;
+    setPhase: (phase: ArtifactPhase, error?: Error) => void;
+}
+export declare function useArtifactLifecycle(): ArtifactLifecycle;
+export declare function useArtifactPhase(): ArtifactPhase;
+export interface StartArtifactConfig {
+    onReady?: () => void | Promise<void>;
+    onError?: (error: Error) => void;
+}
+export declare function useStartArtifact(config: StartArtifactConfig, lifecycle: ArtifactLifecycle): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CACzD;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAUxD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAmBhG"}

package/dist/lifecycle.js

@@ -0,0 +1,34 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+export function useArtifactLifecycle() {
+    const [phase, setPhaseState] = useState("loading");
+    const [error, setError] = useState(undefined);
+    const setPhase = useCallback((next, err) => {
+        setPhaseState(next);
+        setError(err);
+    }, []);
+    return { phase, error, setPhase };
+}
+export function useArtifactPhase() {
+    return useArtifactLifecycle().phase;
+}
+export function useStartArtifact(config, lifecycle) {
+    const configRef = useRef(config);
+    configRef.current = config;
+    const setPhase = lifecycle.setPhase;
+    useEffect(() => {
+        // fallow-ignore-next-line complexity
+        const run = async () => {
+            try {
+                await configRef.current.onReady?.();
+                setPhase("ready");
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                setPhase("error", error);
+                configRef.current.onError?.(error);
+            }
+        };
+        void run();
+    }, [setPhase]);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AASjE,MAAM,UAAU,oBAAoB;IAClC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAgB,SAAS,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAoB,SAAS,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,IAAmB,EAAE,GAAW,EAAE,EAAE;QAChE,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,oBAAoB,EAAE,CAAC,KAAK,CAAC;AACtC,CAAC;AAOD,MAAM,UAAU,gBAAgB,CAAC,MAA2B,EAAE,SAA4B;IACxF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;IAEpC,SAAS,CAAC,GAAG,EAAE;QACb,qCAAqC;QACrC,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;YACrB,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBACpC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACzB,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;QACH,CAAC,CAAC;QACF,KAAK,GAAG,EAAE,CAAC;IACb,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjB,CAAC"}

package/dist/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@alistigo/artifact-core",
+  "version": "0.2.0",
+  "description": "Shared lifecycle, phases, error boundary, and plugin integration for Alistigo artifacts.",
+  "license": "MIT",
+  "author": {
+    "name": "Mikael Labrut",
+    "email": "contact@alistigo.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alistigo/holos.git",
+    "directory": "packages/artifact-core"
+  },
+  "bugs": {
+    "url": "https://github.com/alistigo/holos/issues"
+  },
+  "homepage": "https://github.com/alistigo/holos/tree/main/packages/artifact-core#readme",
+  "keywords": [
+    "alistigo",
+    "artifact",
+    "core",
+    "lifecycle",
+    "typescript"
+  ],
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@alistigo/artifact-plugin-api": "workspace:*",
+    "@alistigo/logger": "workspace:*"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14"
+  },
+  "module": "./index.js"
+}

package/dist/phase.d.ts

@@ -0,0 +1,2 @@
+export type ArtifactPhase = "loading" | "ready" | "error";
+//# sourceMappingURL=phase.d.ts.map

package/dist/phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../src/phase.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC"}

package/dist/phase.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=phase.js.map

package/dist/phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../src/phase.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@alistigo/artifact-core",
+  "version": "0.2.0",
+  "description": "Shared lifecycle, phases, error boundary, and plugin integration for Alistigo artifacts.",
+  "license": "MIT",
+  "author": {
+    "name": "Mikael Labrut",
+    "email": "contact@alistigo.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alistigo/holos.git",
+    "directory": "packages/artifact-core"
+  },
+  "bugs": {
+    "url": "https://github.com/alistigo/holos/issues"
+  },
+  "homepage": "https://github.com/alistigo/holos/tree/main/packages/artifact-core#readme",
+  "keywords": [
+    "alistigo",
+    "artifact",
+    "core",
+    "lifecycle",
+    "typescript"
+  ],
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@alistigo/artifact-plugin-api": "0.1.7",
+    "@alistigo/logger": "0.2.11"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14"
+  }
+}