@astrale-os/sdk 0.5.0-beta.120 → 0.5.0-beta.121

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.5.0-beta.121](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.120...sdk-v0.5.0-beta.121) (2026-09-07)
+
+
+### Features
+
+* **graph:** expose local aliases for SDK authoring ([#443](https://github.com/astrale-os/sdk/issues/443)) ([16dffa3](https://github.com/astrale-os/sdk/commit/16dffa3b904899f9aba53aac22676b53ffbbdae3))
+
 ## [0.5.0-beta.120](https://github.com/astrale-os/sdk/compare/sdk-v0.5.0-beta.119...sdk-v0.5.0-beta.120) (2026-09-07)
 
 

package/dist/application/mutation/authoring/builder.js

@@ -1,5 +1,5 @@
-import { LocalBinding } from '@astrale-os/kernel-core/graph/graph';
 import { ClassKey } from '@astrale-os/kernel-dsl/v1/addressing';
+import { LocalAlias } from '../../../platform/graph/alias.js';
 import { endpoint, existingEndpoint } from './endpoint.js';
 import { precondition } from './precondition.js';
 import { conditions, delta, properties } from './properties.js';
@@ -33,7 +33,7 @@ export function richMutationBuilder(core) {
         expect: expectation,
         createNode(input) {
             const created = core.createNode({
-                as: LocalBinding(input.as),
+                as: LocalAlias(input.as),
                 class: classKey(input.class),
                 ...(input.props === undefined ? {} : { props: properties(input.class, input.props) }),
             });

package/dist/application/mutation/authoring/endpoint.d.ts

@@ -1,9 +1,9 @@
-import type { LocalBinding } from '@astrale-os/kernel-core/graph/graph';
 import type { NodeId } from '@astrale-os/kernel-core/graph/node';
 import type { NodeTarget } from '@astrale-os/kernel-core/path';
 import type { ResolvedClass } from '@astrale-os/kernel-dsl/v1';
+import type { LocalAlias } from '../../../platform/graph/alias.js';
 export interface CreatedNode<Class extends ResolvedClass<'node'> = ResolvedClass<'node'>> {
-    readonly created: LocalBinding;
+    readonly created: LocalAlias;
     readonly class: Class;
 }
 export type ExistingEndpoint = NodeTarget | Readonly<{
@@ -11,6 +11,6 @@ export type ExistingEndpoint = NodeTarget | Readonly<{
 }>;
 export type MutationEndpoint = ExistingEndpoint | CreatedNode;
 export declare function endpoint(input: MutationEndpoint): NodeTarget | {
-    readonly created: LocalBinding;
+    readonly created: LocalAlias;
 };
 export declare function existingEndpoint(input: ExistingEndpoint): NodeTarget;

package/dist/application/mutation/index.d.ts

@@ -5,3 +5,4 @@ export type { Mutation, MutationDefinition, MutationInputOf, MutationOutputOf }
 export type { CreatedNode, EdgeSelector, ExistingEndpoint, MutationEndpoint, QueryPrecondition, RichMutationBuilder, RichPropertyConditions, RichPropertyDelta, RichPropertyInput, RichPropertyName, } from './authoring/index.js';
 /** Canonical low-level Mutation documents remain available as the explicit escape hatch. */
 export * from '@astrale-os/kernel-core/graph/mutate';
+export type { LocalAlias, LocalBinding } from '../../platform/graph/alias.js';

package/dist/platform/graph/alias.d.ts

@@ -0,0 +1,12 @@
+import { type LocalBinding as CanonicalBinding } from '@astrale-os/kernel-core/graph/graph';
+/** A name scoped to one graph or mutation, distinct from a persistent Node identity. */
+export type LocalAlias = CanonicalBinding;
+/** Admit a local name using the canonical Kernel grammar. */
+export declare function LocalAlias(input: string): LocalAlias;
+export declare const isLocalAlias: (input: unknown) => input is LocalAlias;
+/** @deprecated Use LocalAlias. */
+export type LocalBinding = LocalAlias;
+/** @deprecated Use LocalAlias. */
+export declare const LocalBinding: typeof LocalAlias;
+/** @deprecated Use isLocalAlias. */
+export declare const isLocalBinding: (input: unknown) => input is LocalAlias;

package/dist/platform/graph/alias.js

@@ -0,0 +1,13 @@
+import { isLocalBinding as isCanonicalBinding, } from '@astrale-os/kernel-core/graph/graph';
+/** Admit a local name using the canonical Kernel grammar. */
+export function LocalAlias(input) {
+    if (!isLocalAlias(input)) {
+        throw new TypeError(`Invalid local alias ${JSON.stringify(input)}.`);
+    }
+    return input;
+}
+export const isLocalAlias = isCanonicalBinding;
+/** @deprecated Use LocalAlias. */
+export const LocalBinding = LocalAlias;
+/** @deprecated Use isLocalAlias. */
+export const isLocalBinding = isLocalAlias;

package/dist/platform/graph/document/index.d.ts

@@ -1,2 +1,3 @@
-/** Canonical graph documents and local bindings. */
+/** Canonical graph documents and local aliases. */
 export * from '@astrale-os/kernel-core/graph/graph';
+export { LocalAlias, isLocalAlias, LocalBinding, isLocalBinding } from '../alias.js';

package/dist/platform/graph/document/index.js

@@ -1,2 +1,3 @@
-/** Canonical graph documents and local bindings. */
+/** Canonical graph documents and local aliases. */
 export * from '@astrale-os/kernel-core/graph/graph';
+export { LocalAlias, isLocalAlias, LocalBinding, isLocalBinding } from '../alias.js';

package/dist/platform/graph/index.d.ts

@@ -1,5 +1,6 @@
 /** Curated aggregate over canonical graph values. */
-export { GraphData, GraphDataDecodeError, GraphSpec, GraphSpecDecodeError, LocalBinding, } from '@astrale-os/kernel-core/graph/graph';
+export { GraphData, GraphDataDecodeError, GraphSpec, GraphSpecDecodeError, } from '@astrale-os/kernel-core/graph/graph';
+export { LocalAlias, isLocalAlias, LocalBinding, isLocalBinding } from './alias.js';
 export type { AnonymousNodeSpec, GraphDataJson, GraphSpecEdge, GraphSpecEndpoint, GraphSpecJson, GraphSpecNode, } from '@astrale-os/kernel-core/graph/graph';
 export * from './edge/index.js';
 export * from './node/index.js';

package/dist/platform/graph/index.js

@@ -1,5 +1,6 @@
 /** Curated aggregate over canonical graph values. */
-export { GraphData, GraphDataDecodeError, GraphSpec, GraphSpecDecodeError, LocalBinding, } from '@astrale-os/kernel-core/graph/graph';
+export { GraphData, GraphDataDecodeError, GraphSpec, GraphSpecDecodeError, } from '@astrale-os/kernel-core/graph/graph';
+export { LocalAlias, isLocalAlias, LocalBinding, isLocalBinding } from './alias.js';
 export * from './edge/index.js';
 export * from './node/index.js';
 export * from './path/index.js';

package/package.json

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