iso-ucan 0.0.1 → 0.1.6

package/dist/src/capability.d.ts

@@ -30,12 +30,17 @@ export class Capability<Schema extends StandardSchemaV1, Cmd extends string = st
      */
     validate(args: StandardSchemaV1.InferInput<Schema>): Promise<StandardSchemaV1.Result<any>>;
     /**
+     * Invoke this capability
+     *
      * @param {import("./types.js").CapabilityInvokeOptions<Schema>} options
+     * @returns {Promise<Invocation>}
      */
     invoke(options: import("./types.js").CapabilityInvokeOptions<Schema>): Promise<Invocation>;
     /**
+     * Create a delegation for this capability
      *
      * @param {import("./types.js").CapabilityDelegateOptions} options
+     * @returns {Promise<Delegation>}
      */
     delegate(options: import("./types.js").CapabilityDelegateOptions): Promise<Delegation>;
 }

package/dist/src/capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/capability.js"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAHgC,MAAM,SAAzB,gBAAkB,EACR,GAAG,SAAb,MAAQ;IAWnB;;;;OAIG;IACH,6BAJa,gBAAkB,gBAClB,MAAQ,oBACV,iBAAiB,CAAC,QAAM,EAAE,KAAG,CAAC,+BAIxC;IAfD;;OAEG;IACH,qBAFW,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,EAKxC;IAFC,eAA4B;IAC5B,SAAsB;IAYxB;;OAEG;IACH,eAFW,4BAA4B,MAAM,CAAC,yCAK7C;IAED;;OAEG;IACH,gBAFW,OAAO,YAAY,EAAE,uBAAuB,CAAC,MAAM,CAAC,uBAoB9D;IAED;;;OAGG;IACH,kBAFW,OAAO,YAAY,EAAE,yBAAyB,uBAIxD;CACF;8BAnE+B,MAAM,SAAzB,gBAAkB,EACR,GAAG,SAAb,MAAQ;YAEX,MAAM;SACN,GAAG;;sCARsB,uBAAuB;2BAH/B,iBAAiB;2BADjB,iBAAiB"}
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/capability.js"],"names":[],"mappings":"AAIA;;GAEG;AAEH;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAHgC,MAAM,SAAzB,gBAAkB,EACR,GAAG,SAAb,MAAQ;IAWnB;;;;OAIG;IACH,6BAJa,gBAAkB,gBAClB,MAAQ,oBACV,iBAAiB,CAAC,QAAM,EAAE,KAAG,CAAC,+BAIxC;IAfD;;OAEG;IACH,qBAFW,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,EAKxC;IAFC,eAA4B;IAC5B,SAAsB;IAYxB;;OAEG;IACH,eAFW,4BAA4B,MAAM,CAAC,yCAK7C;IAED;;;;;OAKG;IACH,gBAHW,OAAO,YAAY,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,CAoB/B;IAED;;;;;OAKG;IACH,kBAHW,OAAO,YAAY,EAAE,yBAAyB,GAC5C,OAAO,CAAC,UAAU,CAAC,CAI/B;CACF;8BAxE+B,MAAM,SAAzB,gBAAkB,EACR,GAAG,SAAb,MAAQ;YAEX,MAAM;SACN,GAAG;;sCARsB,uBAAuB;2BAH/B,iBAAiB;2BADjB,iBAAiB"}

package/dist/src/delegation.d.ts

@@ -51,6 +51,28 @@ export class Delegation {
      */
     validate(options: DelegationValidateOptions): Promise<boolean>;
     toString(): string;
+    toJSON(): {
+        token: string;
+        cid: string;
+        envelope: {
+            payload: {
+                iss: string;
+                aud: string;
+                sub: string | null;
+                cmd: string;
+                pol: Policy;
+                exp: number | null;
+                nbf: number | undefined;
+                nonce: string;
+                meta: Record<string, unknown> | undefined;
+            };
+            signature: string;
+            alg: import("iso-signatures/types").SignatureType;
+            enc: import("./types.js").VarsigEncoding;
+            spec: "dlg";
+            version: string;
+        };
+    };
 }
 import type { DIDURL } from './types.js';
 import type { DID } from './types.js';

package/dist/src/delegation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delegation.d.ts","sourceRoot":"","sources":["../../src/delegation.js"],"names":[],"mappings":"AAgBA;;;GAGG;AAEH;;GAEG;AACH;IA0CE;;;OAGG;IACH,qBAFW,OAAO,YAAY,EAAE,qBAAqB,uBAuBpD;IAED;;;OAGG;IACH,uBAFW,iBAAiB,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,uBA6C7C;IAhGD;;;;;OAKG;IACH,sBAJW,OAAO,YAAY,EAAE,eAAe,CAAC,KAAK,CAAC,SAC3C,UAAU,OACV,GAAG,EAgBb;IAvCD,qBAAqB;IACrB,KADW,MAAM,CACd;IACH,kBAAkB;IAClB,KADW,GAAG,CACX;IACH,yBAAyB;IACzB,KADW,GAAG,GAAG,IAAI,CAClB;IACH,qBAAqB;IACrB,KADW,MAAM,CACd;IACH,qBAAqB;IACrB,KADW,MAAM,CACd;IACH,iCAAiC;IACjC,KADW,MAAM,GAAG,SAAS,CAC1B;IACH,yBAAyB;IACzB,OADW,UAAU,CAChB;IACL,kDAAkD;IAClD,MADW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAC1C;IACJ,4BAA4B;IAC5B,KADW,MAAM,GAAG,IAAI,CACrB;IASD,sDAAwB;IACxB,mCAAkB;IAClB,8DAAc;IAyFhB;;OAEG;IACH,kBAFW,yBAAyB,oBAanC;IAED,mBAEC;CACF;4BAhJsG,YAAY;yBAAZ,YAAY;4BAAZ,YAAY;yBAC7F,cAAc;+CADmE,YAAY;uCAAZ,YAAY"}
+{"version":3,"file":"delegation.d.ts","sourceRoot":"","sources":["../../src/delegation.js"],"names":[],"mappings":"AAgBA;;;GAGG;AAEH;;GAEG;AACH;IA0CE;;;OAGG;IACH,qBAFW,OAAO,YAAY,EAAE,qBAAqB,uBAuBpD;IAED;;;OAGG;IACH,uBAFW,iBAAiB,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,uBA6C7C;IAhGD;;;;;OAKG;IACH,sBAJW,OAAO,YAAY,EAAE,eAAe,CAAC,KAAK,CAAC,SAC3C,UAAU,OACV,GAAG,EAgBb;IAvCD,qBAAqB;IACrB,KADW,MAAM,CACd;IACH,kBAAkB;IAClB,KADW,GAAG,CACX;IACH,yBAAyB;IACzB,KADW,GAAG,GAAG,IAAI,CAClB;IACH,qBAAqB;IACrB,KADW,MAAM,CACd;IACH,qBAAqB;IACrB,KADW,MAAM,CACd;IACH,iCAAiC;IACjC,KADW,MAAM,GAAG,SAAS,CAC1B;IACH,yBAAyB;IACzB,OADW,UAAU,CAChB;IACL,kDAAkD;IAClD,MADW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAC1C;IACJ,4BAA4B;IAC5B,KADW,MAAM,GAAG,IAAI,CACrB;IASD,sDAAwB;IACxB,mCAAkB;IAClB,8DAAc;IAyFhB;;OAEG;IACH,kBAFW,yBAAyB,oBAanC;IAED,mBAEC;IACD;;;;;;;;;;;;;;;;;;;;;MAuBC;CACF;4BAxKsG,YAAY;yBAAZ,YAAY;4BAAZ,YAAY;yBAC7F,cAAc;+CADmE,YAAY;uCAAZ,YAAY"}

package/dist/src/server.d.ts

@@ -1,5 +1,42 @@
-import type { StandardSchemaV1 } from '@standard-schema/spec';
-import type { Capability } from './capability.js';
-import type { RouteOptions, RouteOutput } from './types.js';
-export declare function route<Cap extends Capability<StandardSchemaV1>, Output>(options: RouteOptions<Cap, Output>): RouteOutput<Cap, Output>;
+/**
+ * @import { RouteOutput, StandardSchemaV1, RouteOptions, RouteHandlerOptions} from './types'
+ * @import {Capability} from './capability'
+ */
+/**
+ * Workaround to make imports types work
+ * @template {Capability<StandardSchemaV1, string>} T
+ * @template Output
+ * @typedef {Object} DELETE_ME
+ * @prop {string} url
+ * @prop {Capability<StandardSchemaV1, string>[]} capabilities
+ * @prop {RouteOutput<T, Output>} router
+ * @prop {RouteOptions<T, Output>} options
+ * @prop {RouteHandlerOptions} routerClient
+ */
+/**
+ * @template Output
+ * @template {Capability<StandardSchemaV1>} Cap
+ * @param {RouteOptions<Cap, Output>} options
+ * @returns {RouteOutput<Cap, Output>}
+ */
+export function route<Output, Cap extends Capability<StandardSchemaV1>>(options: RouteOptions<Cap, Output>): RouteOutput<Cap, Output>;
+/**
+ * Workaround to make imports types work
+ */
+export type DELETE_ME<T extends Capability<StandardSchemaV1, string>, Output> = {
+    url: string;
+    capabilities: Capability<StandardSchemaV1, string>[];
+    router: RouteOutput<T, Output>;
+    options: RouteOptions<T, Output>;
+    routerClient: RouteHandlerOptions;
+};
+import type { StandardSchemaV1 } from './types';
+import type { Capability } from './capability';
+import type { RouteOptions } from './types';
+import type { RouteOutput } from './types';
+import type { StandardSchemaV1 as StandardSchemaV1_1 } from './types';
+import type { Capability as Capability_1 } from './capability';
+import type { RouteOutput as RouteOutput_1 } from './types';
+import type { RouteOptions as RouteOptions_1 } from './types';
+import type { RouteHandlerOptions } from './types';
 //# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAuB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEhF,wBAAgB,KAAK,CAAC,GAAG,SAAS,UAAU,CAAC,gBAAgB,CAAC,EAAE,MAAM,EACpE,OAAO,EAAE,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,GACjC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAiB1B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.js"],"names":[],"mappings":"AAIA;;;GAGG;AAEH;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,sBALa,MAAM,EACyB,GAAG,SAAlC,WAAY,gBAAgB,CAAE,WAChC,aAAa,GAAG,EAAE,MAAM,CAAC,GACvB,YAAY,GAAG,EAAE,MAAM,CAAC,CAqBpC;;;;sBAnCmD,CAAC,SAAxC,WAAY,gBAAgB,EAAE,MAAM,CAAE,EACtC,MAAM;SAET,MAAM;kBACN,WAAW,gBAAgB,EAAE,MAAM,CAAC,EAAE;YACtC,YAAY,CAAC,EAAE,MAAM,CAAC;aACtB,aAAa,CAAC,EAAE,MAAM,CAAC;kBACvB,mBAAmB;;sCAbuD,SAAS;gCAChE,cAAc;kCADyC,SAAS;iCAAT,SAAS;4DAAT,SAAS;gDAChE,cAAc;kDADyC,SAAS;oDAAT,SAAS;yCAAT,SAAS"}

package/dist/src/types/envelope.d.ts

@@ -0,0 +1,119 @@
+import type { DID, DIDURL } from 'iso-did/types';
+import type { ISigner } from 'iso-signatures/types';
+import type { CID } from 'multiformats';
+import type { Policy } from './policy';
+import type { VarsigAlgorithm, VarsigEncoding } from './varsig';
+/**
+ * Envelope types
+ */
+export type PayloadSpec = 'dlg' | 'inv';
+export type PayloadTag = `ucan/${PayloadSpec}@${string}`;
+export interface PayloadBase {
+    /**
+     * Issuer DID (sender)
+     */
+    iss: DIDURL;
+    /**
+     * Audience DID (receiver)
+     */
+    aud?: DID;
+    /**
+     * Principal that the chain is about (the [Subject])
+     */
+    sub?: DID | null;
+    /**
+     * The Command to eventually invoke
+     * @see https://github.com/ucan-wg/spec#command
+     */
+    cmd: string;
+    /**
+     * The nonce of the UCAN
+     * @see https://github.com/ucan-wg/spec#nonce
+     */
+    nonce: Uint8Array;
+    /**
+     * Meta (asserted, signed data) — is not delegated authority
+     */
+    meta?: Record<string, unknown>;
+    /**
+     * Expiration UTC Unix Timestamp in seconds (valid until)
+     */
+    exp: number | null;
+    /**
+     * "Not before" UTC Unix Timestamp in seconds (valid from)
+     */
+    nbf?: number;
+}
+/**
+ * @see https://github.com/ucan-wg/invocation#invocation-payload
+ */
+export interface InvocationPayload extends PayloadBase {
+    sub: DID;
+    /**
+     * Optional if equal to subject
+     */
+    aud?: DID;
+    /**
+     * Any [Arguments] that MUST be present in the Invocation
+     */
+    args: Record<string, unknown>;
+    /**
+     * Delegations that prove the chain of authority
+     */
+    prf: CID[];
+    /**
+     * Issued at time
+     */
+    iat?: number;
+    /**
+     * An OPTIONAL CID of the Receipt that enqueued the Task
+     */
+    cause?: CID;
+}
+export interface DelegationPayload<Args = unknown> extends PayloadBase {
+    aud: DID;
+    /**
+     * Subject can be null here for Powerline
+     * @see https://github.com/ucan-wg/delegation/#powerline
+     */
+    sub: DID | null;
+    pol: Policy<Args>;
+}
+export type Payload<Args = unknown> = InvocationPayload | DelegationPayload<Args>;
+export type SignaturePayload<Args = unknown> = {
+    h: Uint8Array;
+    [payloadTag: PayloadTag]: Payload<Args>;
+};
+export type Envelope<Args = unknown> = [Uint8Array, SignaturePayload<Args>];
+/**
+ * @see https://github.com/ucan-wg/spec#envelope
+ */
+export type EnvelopeEncodeOptions = {
+    signature: Uint8Array;
+    signaturePayload: SignaturePayload;
+};
+export interface EnvelopeSignOptions {
+    /**
+     * @default '1.0.0'
+     */
+    version?: string;
+    /**
+     * @default 'DAG-CBOR'
+     */
+    enc?: VarsigEncoding;
+    spec: PayloadSpec;
+    payload: Payload;
+    signer: ISigner;
+}
+export interface EnvelopeDecodeOptions {
+    envelope: Uint8Array;
+}
+export type DecodedEnvelope<Spec extends PayloadSpec> = {
+    alg: VarsigAlgorithm;
+    enc: VarsigEncoding;
+    signature: Uint8Array;
+    payload: Spec extends 'dlg' ? DelegationPayload : InvocationPayload;
+    spec: Spec;
+    version: string;
+};
+//# sourceMappingURL=envelope.d.ts.map

package/dist/src/types/envelope.d.ts.map

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

package/dist/src/types/policy.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Policy types
+ * @see https://github.com/ucan-wg/delegation/#policy
+ */
+/**
+ * Type-safe selector utilities
+ */
+/**
+ * Extracts all possible paths from a data structure as string literals
+ */
+type PathsToStringProps<T> = T extends string | number | boolean | null | undefined ? never : T extends Array<infer U> ? `[]` | `[${number}]` | `[${number}:${number}]` | `[${number}:]` | `[:${number}]` | `[:]` | PathsToStringProps<U> : T extends object ? {
+    [K in keyof T & (string | number)]: K extends string ? `.${K}` | `.${K}?` | `.${K}${PathsToStringProps<T[K]>}` : `[${K}]` | `[${K}]?` | `[${K}]${PathsToStringProps<T[K]>}`;
+}[keyof T & (string | number)] : never;
+/**
+ * Flattens nested path strings into a union of all possible selectors
+ */
+type FlattenPaths<T> = T extends string ? T : T extends object ? {
+    [K in keyof T]: T[K] extends string ? T[K] : T[K] extends object ? FlattenPaths<T[K]> : never;
+}[keyof T] : never;
+/**
+ * Type-safe selector that only allows valid paths for the given data structure
+ */
+export type Selector<Args = unknown> = Args extends unknown ? FlattenPaths<PathsToStringProps<Args>> | '.' : string;
+/**
+ * Extracts the type of the value at a given selector path (minimal version)
+ */
+type SelectorValue<T, S extends string> = S extends `.${infer K}` ? K extends keyof T ? T[K] : never : S extends `[${infer I}]` ? T extends Array<infer U> ? U : never : never;
+/** Connectives */
+export type EqualityOp = '==' | '!=';
+export type Equality<Args = unknown> = [EqualityOp, Selector<Args>, unknown];
+export type InequalityOp = '<' | '<=' | '>' | '>=';
+export type Inequality<Args = unknown> = [InequalityOp, Selector<Args>, number];
+export type NegateOp = 'not';
+export type Negate<Args = unknown> = [NegateOp, Statement<Args>];
+export type ConnectiveOp = 'and' | 'or';
+export type Connective<Args = unknown> = [ConnectiveOp, Statement<Args>[]];
+export type QuantifierOp = 'all' | 'any';
+export type Quantifier<Args = unknown, Sel extends Selector<Args> = Selector<Args>> = [QuantifierOp, Sel, Statement<SelectorValue<Args, Sel>>];
+export type LikeOp = 'like';
+export type Like<Args = unknown> = [LikeOp, Selector<Args>, string];
+export type Statement<Args = unknown> = Equality<Args> | Inequality<Args> | Negate<Args> | Connective<Args> | Quantifier<Args> | Like<Args>;
+export type Policy<Args = unknown> = Statement<Args>[];
+export {};
+//# sourceMappingURL=policy.d.ts.map

package/dist/src/types/policy.d.ts.map

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

package/dist/src/types/varsig.d.ts

@@ -0,0 +1,18 @@
+import type { SignatureType } from 'iso-signatures/types';
+/**
+ * Varsig types
+ */
+/**
+ * Supported encoding types for data to be signed or verified
+ */
+export type VarsigEncoding = 'RAW' | 'DAG-CBOR';
+/**
+ * Supported signature types
+ */
+export type VarsigAlgorithm = SignatureType;
+export interface VarsigOptions {
+    enc: VarsigEncoding;
+    alg: VarsigAlgorithm;
+}
+export type DecodeOutput = VarsigOptions;
+//# sourceMappingURL=varsig.d.ts.map

package/dist/src/types/varsig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"varsig.d.ts","sourceRoot":"","sources":["../../../src/types/varsig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,UAAU,CAAA;AAE/C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,CAAA;AAE3C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,cAAc,CAAA;IACnB,GAAG,EAAE,eAAe,CAAA;CACrB;AAED,MAAM,MAAM,YAAY,GAAG,aAAa,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "iso-ucan",
   "type": "module",
-  "version": "0.0.1",
+  "version": "0.1.6",
   "description": "Isomorphic UCAN",
   "author": "Hugo Dias <hugomrdias@gmail.com> (hugodias.me)",
   "license": "MIT",
@@ -98,8 +98,8 @@
   },
   "files": [
     "src",
-    "dist/src/*.d.ts",
-    "dist/src/*.d.ts.map"
+    "dist/src/**/*.d.ts",
+    "dist/src/**/*.d.ts.map"
   ],
   "dependencies": {
     "@ipld/dag-cbor": "^9.2.4",
@@ -110,9 +110,9 @@
     "iso-web": "^1.1.1",
     "it-merge": "^3.0.12",
     "multiformats": "^13.3.7",
-    "iso-base": "^4.0.2",
-    "iso-did": "^1.8.0",
-    "iso-signatures": "^0.3.2"
+    "iso-did": "^2.0.0",
+    "iso-signatures": "^0.4.0",
+    "iso-base": "^4.1.0"
   },
   "devDependencies": {
     "@types/node": "^24.1.0",

package/src/capability.js

@@ -45,7 +45,10 @@ export class Capability {
   }
 
   /**
+   * Invoke this capability
+   *
    * @param {import("./types.js").CapabilityInvokeOptions<Schema>} options
+   * @returns {Promise<Invocation>}
    */
   async invoke(options) {
     const result = await this.schema['~standard'].validate(options.args)
@@ -68,8 +71,10 @@ export class Capability {
   }
 
   /**
+   * Create a delegation for this capability
    *
    * @param {import("./types.js").CapabilityDelegateOptions} options
+   * @returns {Promise<Delegation>}
    */
   delegate(options) {
     return Delegation.create({ ...options, cmd: this.cmd })

package/src/delegation.js

@@ -159,6 +159,30 @@ export class Delegation {
   toString() {
     return base64pad.encode(this.bytes)
   }
+  toJSON() {
+    return {
+      token: this.toString(),
+      cid: this.cid.toString(),
+      envelope: {
+        payload: {
+          iss: this.iss.toString(),
+          aud: this.aud.toString(),
+          sub: this.sub ? this.sub.toString() : null,
+          cmd: this.cmd,
+          pol: this.pol,
+          exp: this.exp,
+          nbf: this.nbf,
+          nonce: base64pad.encode(this.nonce),
+          meta: this.meta,
+        },
+        signature: base64pad.encode(this.envelope.signature),
+        alg: this.envelope.alg,
+        enc: this.envelope.enc,
+        spec: this.envelope.spec,
+        version: this.envelope.version,
+      },
+    }
+  }
 }
 
 /**

package/src/server.js

@@ -0,0 +1,47 @@
+// import type { StandardSchemaV1 } from '@standard-schema/spec'
+// import type { Capability } from './capability.js'
+// import type { RouteHandlerOptions, RouteOptions, RouteOutput } from './types.js'
+
+/**
+ * @import { RouteOutput, StandardSchemaV1, RouteOptions, RouteHandlerOptions} from './types'
+ * @import {Capability} from './capability'
+ */
+
+/**
+ * Workaround to make imports types work
+ * @template {Capability<StandardSchemaV1, string>} T
+ * @template Output
+ * @typedef {Object} DELETE_ME
+ * @prop {string} url
+ * @prop {Capability<StandardSchemaV1, string>[]} capabilities
+ * @prop {RouteOutput<T, Output>} router
+ * @prop {RouteOptions<T, Output>} options
+ * @prop {RouteHandlerOptions} routerClient
+ */
+
+/**
+ * @template Output
+ * @template {Capability<StandardSchemaV1>} Cap
+ * @param {RouteOptions<Cap, Output>} options
+ * @returns {RouteOutput<Cap, Output>}
+ */
+export function route(options) {
+  return {
+    cap: options.capability,
+    fn: async (
+      /** @type {RouteHandlerOptions} */ { request, issuer, invocation, store }
+    ) => {
+      const { capability, handler } = options
+
+      const args = await capability.validate(invocation.payload.args)
+      if (args.issues) {
+        throw new Error(args.issues.map((issue) => issue.message).join(', '))
+      }
+
+      // TODO: handle failure
+      const result = await handler({ args: args.value, store })
+
+      return result
+    },
+  }
+}

package/src/server.ts

@@ -1,24 +0,0 @@
-import type { StandardSchemaV1 } from '@standard-schema/spec'
-import type { Capability } from './capability.js'
-import type { RouteHandlerOptions, RouteOptions, RouteOutput } from './types.js'
-
-export function route<Cap extends Capability<StandardSchemaV1>, Output>(
-  options: RouteOptions<Cap, Output>
-): RouteOutput<Cap, Output> {
-  return {
-    cap: options.capability,
-    fn: async ({ request, issuer, invocation, store }: RouteHandlerOptions) => {
-      const { capability, handler } = options
-
-      const args = await capability.validate(invocation.payload.args)
-      if (args.issues) {
-        throw new Error(args.issues.map((issue) => issue.message).join(', '))
-      }
-
-      // TODO: handle failure
-      const result = await handler({ args: args.value, store })
-
-      return result
-    },
-  }
-}