@astrale-os/sdk 0.4.11 → 0.4.13

package/src/server/config.ts

@@ -9,7 +9,7 @@ import type { CorsConfig, WsAdapter } from '@astrale-os/kernel-server'
 import type { Context } from 'hono'
 import type { Hono } from 'hono'
 
-import type { RemoteDomain } from '../domain/define'
+import type { RemoteDomain } from '../domain/define.js'
 
 export type RemoteServerConfig<TDeps> = {
   /** Domain produced by `defineRemoteDomain(...)`. */

package/src/server/create.ts

@@ -15,20 +15,20 @@ import { createKernelApp } from '@astrale-os/kernel-server'
 import { Hono } from 'hono'
 import { importJWK, SignJWT } from 'jose'
 
-import type { ViewDef } from '../define'
-import type { RemoteServerConfig } from './config'
-import type { RemoteServer, RemoteServerHandle } from './handle'
-
-import { MetaSchema } from '../deploy/meta'
-import { SdkDispatcher } from '../dispatch/dispatcher'
-import { buildAuxIdentityMap } from '../dispatch/identity'
-import { buildMethodIndex } from '../dispatch/resolve'
-import { buildInstallGraph, buildInstallGraphHash } from '../domain/build-spec'
-import { toSdkContract } from '../domain/contract'
-import { materializeRemoteDomain } from '../domain/define'
-import { mountAuxiliaryRoutes } from './auxiliary-routes'
-import { derivePublicJwk } from './jwks'
-import { canonicalizeServingUrl } from './serving-url'
+import type { ViewDef } from '../define/index.js'
+import type { RemoteServerConfig } from './config.js'
+import type { RemoteServer, RemoteServerHandle } from './handle.js'
+
+import { MetaSchema } from '../deploy/meta.js'
+import { SdkDispatcher } from '../dispatch/dispatcher.js'
+import { buildAuxIdentityMap } from '../dispatch/identity.js'
+import { buildMethodIndex } from '../dispatch/resolve.js'
+import { buildInstallGraph, buildInstallGraphHash } from '../domain/build-spec.js'
+import { toSdkContract } from '../domain/contract.js'
+import { materializeRemoteDomain } from '../domain/define.js'
+import { mountAuxiliaryRoutes } from './auxiliary-routes.js'
+import { derivePublicJwk } from './jwks.js'
+import { canonicalizeServingUrl } from './serving-url.js'
 
 export function createRemoteServer<TDeps>(config: RemoteServerConfig<TDeps>): RemoteServer {
   const methods = buildMethodIndex(config.domain.methods)
@@ -143,7 +143,7 @@ export function createRemoteServer<TDeps>(config: RemoteServerConfig<TDeps>): Re
   }
 
   const { app } = createKernelApp({
-    kernel: dispatcher,
+    dispatcher,
     domain: config.domain.methods.map(toSdkContract),
     host: { url: config.url },
     jwks,

package/src/server/domain-entry.ts

@@ -18,14 +18,14 @@
 import type { Core, Schema } from '@astrale-os/kernel-dsl'
 import type { Hono } from 'hono'
 
-import type { DomainManifest } from '../config/define-domain'
-import type { AnyRemoteFunctionDef, ViewDef } from '../define'
-import type { SchemaMethodsImpl } from '../method'
-import type { RemoteServerConfig } from './config'
-import type { WorkerEntry, WorkerEntryConfig } from './worker-entry'
+import type { DomainManifest } from '../config/define-domain.js'
+import type { AnyRemoteFunctionDef, ViewDef } from '../define/index.js'
+import type { SchemaMethodsImpl } from '../method/index.js'
+import type { RemoteServerConfig } from './config.js'
+import type { WorkerEntry, WorkerEntryConfig } from './worker-entry.js'
 
-import { defineRemoteDomain } from '../domain'
-import { createWorkerEntry } from './worker-entry'
+import { defineRemoteDomain } from '../domain/index.js'
+import { createWorkerEntry } from './worker-entry.js'
 
 export interface DomainWorkerEntryConfig<S extends Schema, TEnv, TDeps> {
   /** The domain schema. */

package/src/server/index.ts

@@ -1,11 +1,11 @@
-export { createRemoteServer } from './create'
-export type { RemoteServerConfig } from './config'
-export type { RemoteServer, RemoteServerHandle } from './handle'
-export { derivePublicJwk } from './jwks'
-export { requireEnv } from './require-env'
-export { canonicalizeServingUrl } from './serving-url'
-export { assets, createWorkerEntry } from './worker-entry'
-export type { WorkerEntry, WorkerEntryConfig } from './worker-entry'
-export { domainWorkerEntry } from './domain-entry'
-export type { DomainWorkerEntryConfig } from './domain-entry'
-export { startNodeServer } from './start'
+export { createRemoteServer } from './create.js'
+export type { RemoteServerConfig } from './config.js'
+export type { RemoteServer, RemoteServerHandle } from './handle.js'
+export { derivePublicJwk } from './jwks.js'
+export { requireEnv } from './require-env.js'
+export { canonicalizeServingUrl } from './serving-url.js'
+export { assets, createWorkerEntry } from './worker-entry.js'
+export type { WorkerEntry, WorkerEntryConfig } from './worker-entry.js'
+export { domainWorkerEntry } from './domain-entry.js'
+export type { DomainWorkerEntryConfig } from './domain-entry.js'
+export { startNodeServer } from './start.js'

package/src/server/start.ts

@@ -6,16 +6,17 @@
  * Cloudflare, consumers go through `server.app.fetch` directly.
  */
 
+import type { serve as nodeServe } from '@hono/node-server'
 import type { Hono } from 'hono'
 
-import type { RemoteServerHandle } from './handle'
+import type { RemoteServerHandle } from './handle.js'
 
 export async function startNodeServer(app: Hono, port = 3000): Promise<RemoteServerHandle> {
   // Opaque specifier: the `./server` barrel re-exports this module, so worker
   // bundles (wrangler/esbuild) traverse it even though they never call it. A
   // literal import() would make them resolve the optional peer and fail.
   const nodeServerModule = '@hono/node-server'
-  const { serve } = (await import(nodeServerModule)) as typeof import('@hono/node-server')
+  const { serve } = (await import(nodeServerModule)) as { serve: typeof nodeServe }
   // oxlint-disable-next-line no-explicit-any
   const server = serve({ fetch: app.fetch, port }) as any
 

package/src/server/worker-entry.ts

@@ -24,11 +24,11 @@
 
 import type { ExecutionContext } from 'hono'
 
-import type { RemoteServerConfig } from './config'
+import type { RemoteServerConfig } from './config.js'
 
-import { createRemoteServer } from './create'
-import { requireEnv } from './require-env'
-import { canonicalizeServingUrl } from './serving-url'
+import { createRemoteServer } from './create.js'
+import { requireEnv } from './require-env.js'
+import { canonicalizeServingUrl } from './serving-url.js'
 
 type Fetcher = { fetch(request: Request): Response | Promise<Response> }
 type App = {

package/src/step/index.ts

@@ -1,4 +1,4 @@
-export { createInlineStep } from './inline'
-export type { InlineStepOptions, StepExecutor } from './inline'
-export { buildStepRun } from './step'
-export type { FunctionStepScope, MethodStepScope, Step, StepRun, StepScope } from './step'
+export { createInlineStep } from './inline.js'
+export type { InlineStepOptions, StepExecutor } from './inline.js'
+export { buildStepRun } from './step.js'
+export type { FunctionStepScope, MethodStepScope, Step, StepRun, StepScope } from './step.js'

package/src/step/inline.ts

@@ -1,6 +1,6 @@
-import type { Step, StepRun, StepScope } from './step'
+import type { Step, StepRun, StepScope } from './step.js'
 
-import { buildStepRun, roundTripStepResult } from './step'
+import { buildStepRun, roundTripStepResult } from './step.js'
 
 export type StepExecutor = <T>(run: StepRun, handler: () => T | Promise<T>) => Promise<T>
 

package/dist/defer/index.d.ts

@@ -1,24 +0,0 @@
-import type { Context } from 'hono';
-/** Internal structural host capability; not part of the author-facing SDK contract. */
-export type HandlerExecutionLifetime = {
-    waitUntil(promise: Promise<unknown>): void;
-};
-/**
- * Work detached from the current handler result.
- *
- * The callback is deliberately lazy: the SDK registers the resulting task with
- * the active execution backend before it starts. Current request-based hosts
- * extend their request lifetime; future durable backends may provide stronger
- * execution guarantees without changing the author-facing API.
- */
-export type DeferredTask = () => void | PromiseLike<unknown>;
-export type Defer = (task: DeferredTask) => void;
-export type HandlerLifecycle = {
-    defer: Defer;
-    settle(): Promise<void>;
-};
-/** Bind detached work to the host, with a safe blocking fallback for other runtimes. */
-export declare function createHandlerLifecycle(lifetime?: HandlerExecutionLifetime): HandlerLifecycle;
-/** Hono omits its execution context in Node and in lightweight unit tests. */
-export declare function executionLifetime(c: Context): HandlerExecutionLifetime | undefined;
-//# sourceMappingURL=index.d.ts.map

package/dist/defer/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/defer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAC3C,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;AAE5D,MAAM,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;AAEhD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB,CAAA;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,wBAAwB,GAAG,gBAAgB,CA4B5F;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,wBAAwB,GAAG,SAAS,CAOlF"}

package/dist/defer/index.js

@@ -1,42 +0,0 @@
-/** Bind detached work to the host, with a safe blocking fallback for other runtimes. */
-export function createHandlerLifecycle(lifetime) {
-    const pending = [];
-    return {
-        defer(task) {
-            const promise = Promise.resolve().then(task);
-            if (lifetime)
-                lifetime.waitUntil(promise);
-            else
-                pending.push(promise);
-        },
-        async settle() {
-            if (lifetime || pending.length === 0)
-                return;
-            // A deferred task may register more work before it settles. Drain until
-            // the lifecycle is stable so non-request runtimes never abandon children.
-            let cursor = 0;
-            while (cursor < pending.length) {
-                const batch = pending.slice(cursor);
-                cursor = pending.length;
-                const results = await Promise.allSettled(batch);
-                for (const result of results) {
-                    if (result.status === 'rejected') {
-                        // oxlint-disable-next-line no-console
-                        console.error('[sdk] deferred task failed:', result.reason);
-                    }
-                }
-            }
-        },
-    };
-}
-/** Hono omits its execution context in Node and in lightweight unit tests. */
-export function executionLifetime(c) {
-    try {
-        const host = c.executionCtx;
-        return { waitUntil: (promise) => host.waitUntil(promise) };
-    }
-    catch {
-        return undefined;
-    }
-}
-//# sourceMappingURL=index.js.map

package/dist/defer/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/defer/index.ts"],"names":[],"mappings":"AAwBA,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CAAC,QAAmC;IACxE,MAAM,OAAO,GAAuB,EAAE,CAAA;IAEtC,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC5C,IAAI,QAAQ;gBAAE,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;;gBACpC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;QACD,KAAK,CAAC,MAAM;YACV,IAAI,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAE5C,wEAAwE;YACxE,0EAA0E;YAC1E,IAAI,MAAM,GAAG,CAAC,CAAA;YACd,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBACnC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;gBACvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;gBAC/C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;wBACjC,sCAAsC;wBACtC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;oBAC7D,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,CAAU;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAA;QAC3B,OAAO,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAA;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/src/defer/index.ts

@@ -1,64 +0,0 @@
-import type { Context } from 'hono'
-
-/** Internal structural host capability; not part of the author-facing SDK contract. */
-export type HandlerExecutionLifetime = {
-  waitUntil(promise: Promise<unknown>): void
-}
-
-/**
- * Work detached from the current handler result.
- *
- * The callback is deliberately lazy: the SDK registers the resulting task with
- * the active execution backend before it starts. Current request-based hosts
- * extend their request lifetime; future durable backends may provide stronger
- * execution guarantees without changing the author-facing API.
- */
-export type DeferredTask = () => void | PromiseLike<unknown>
-
-export type Defer = (task: DeferredTask) => void
-
-export type HandlerLifecycle = {
-  defer: Defer
-  settle(): Promise<void>
-}
-
-/** Bind detached work to the host, with a safe blocking fallback for other runtimes. */
-export function createHandlerLifecycle(lifetime?: HandlerExecutionLifetime): HandlerLifecycle {
-  const pending: Promise<unknown>[] = []
-
-  return {
-    defer(task) {
-      const promise = Promise.resolve().then(task)
-      if (lifetime) lifetime.waitUntil(promise)
-      else pending.push(promise)
-    },
-    async settle() {
-      if (lifetime || pending.length === 0) return
-
-      // A deferred task may register more work before it settles. Drain until
-      // the lifecycle is stable so non-request runtimes never abandon children.
-      let cursor = 0
-      while (cursor < pending.length) {
-        const batch = pending.slice(cursor)
-        cursor = pending.length
-        const results = await Promise.allSettled(batch)
-        for (const result of results) {
-          if (result.status === 'rejected') {
-            // oxlint-disable-next-line no-console
-            console.error('[sdk] deferred task failed:', result.reason)
-          }
-        }
-      }
-    },
-  }
-}
-
-/** Hono omits its execution context in Node and in lightweight unit tests. */
-export function executionLifetime(c: Context): HandlerExecutionLifetime | undefined {
-  try {
-    const host = c.executionCtx
-    return { waitUntil: (promise) => host.waitUntil(promise) }
-  } catch {
-    return undefined
-  }
-}