@toa.io/origin 1.3.4 → 1.5.0

package/dist/index.cjs

@@ -135,17 +135,21 @@ var Agent = class {
 var Resource = class {
   agent;
   path;
+  init;
   constructor(options) {
     this.agent = options.agent;
     this.path = options.path;
+    this.init = options.init;
   }
   async json(rel = "", init) {
     const abs = this.abs(rel);
-    return await this.agent.json(abs, init);
+    const options = Object.assign({}, this.init, init);
+    return await this.agent.json(abs, options);
   }
   async octets(rel = "", init) {
     const abs = this.abs(rel);
-    return await this.agent.octets(abs, init);
+    const options = Object.assign({}, this.init, init);
+    return await this.agent.octets(abs, options);
   }
   abs(rel) {
     const base = new URL(this.path, "uri://void");
@@ -167,10 +171,11 @@ var Origin = class {
       events: this.events
     });
   }
-  resource(path) {
+  resource(path, init) {
     return new Resource({
       agent: this.agent,
-      path
+      path,
+      init
     });
   }
   authenticate(challenge) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/index.ts","../source/Origin.ts","../source/Agent.ts","../source/Resource.ts"],"sourcesContent":["export { connect } from './Origin'\nexport type { GenericError } from './Error'\nexport type { OctetsEntry, WorkflowStep } from './Octets'\n","import mitt from 'mitt'\nimport { Agent } from './Agent'\nimport { Resource } from './Resource'\nimport type { Events } from './Events'\nimport type { Emitter } from 'mitt'\n\n/** Resoruce factory */\nclass Origin {\n  public readonly events: Emitter<Events>\n  private readonly agent: Agent\n\n  constructor(options: Options) {\n    this.events = mitt<Events>()\n\n    this.agent = new Agent({\n      origin: options.origin,\n      events: this.events,\n    })\n  }\n\n  public resource<T = unknown>(path: string) {\n    return new Resource<T>({\n      agent: this.agent,\n      path,\n    })\n  }\n\n  public authenticate(challenge: string | null) {\n    this.agent.authenticate(challenge)\n  }\n\n  public use(fetch: Fetch) {\n    this.agent.use(fetch)\n  }\n}\n\nfunction connect(options: Options) {\n  return new Origin(options)\n}\n\ninterface Options {\n  origin: string\n}\n\ntype Fetch = typeof fetch\n\nexport { connect }\n","import { Err } from 'error-value'\nimport { meros } from 'meros/browser'\nimport mitt from 'mitt'\nimport type { GenericError } from './Error'\nimport type { Events } from './Events'\nimport type { Faulty, OctetsEntry, WorkflowStep } from './Octets'\nimport type { Emitter } from 'mitt'\n\nclass Agent {\n  private readonly origin: string\n  private readonly events: Emitter<Events>\n  private fetch: Fetch = fetch\n\n  private challenge: string | null = null\n\n  constructor(options: Options) {\n    this.origin = options.origin\n    this.events = options.events\n  }\n\n  public async json<T, E extends GenericError = GenericError>(path: string, init?: Init): Promise<T | E> {\n    const options = this.setup(init)\n    const response = await this.request(path, options)\n\n    const body = response.headers.get('content-type') === 'application/json'\n      ? await response.json()\n      : await response.text()\n\n    if (response.ok)\n      return body as T\n    else {\n      this.events.emit('error', { code: response.status, body })\n\n      return new Err(response.status, body) as E\n    }\n  }\n\n  public async multipart<T = unknown>(path: string, init?: Init): Promise<AsyncGenerator<T, void, undefined> | GenericError> {\n    const options = this.setup(init)\n    const response = await this.request(path, options)\n\n    if (!response.ok)\n      return new Err(response.status, await response.json())\n\n    const generator = await meros(response) as AsyncGenerator<{ body: string }>\n    const ack = await generator.next()\n\n    if (JSON.parse(ack.value.body) !== 'ACK') throw new Error('No ACK')\n\n    return (async function * () {\n      for await (const chunk of generator) {\n        const value = JSON.parse(chunk.body)\n\n        if (value === 'FIN') return\n\n        yield value\n      }\n    })()\n  }\n\n  public async octets<\n    T extends Record<string, unknown> = Record<string, unknown>,\n    E extends GenericError = GenericError\n  >(path: string, init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E> {\n    const generator = await this.multipart<OctetsEntry | WorkflowStep>(path, init)\n\n    if (generator instanceof Error) return generator as E\n\n    const chunk = await generator.next()\n    const entry = chunk.value as OctetsEntry\n    const emitter = mitt<Faulty<T>>()\n\n    void (async () => {\n      for await (const part of (generator as AsyncGenerator<WorkflowStep>)) {\n        const payload =\n          part.status === 'completed'\n            ? part.output\n            : new Err(part.error?.code ?? 'UNKNOWN', part.error?.message)\n\n        emitter.emit(part.step, payload as T[typeof part.step])\n      }\n\n      emitter.off('*')\n    })()\n\n    return [entry, emitter]\n  }\n\n  public authenticate(challenge: string | null) {\n    this.challenge = challenge\n  }\n\n  public use(fetch: Fetch) {\n    this.fetch = fetch\n  }\n\n  private setup(init?: Init): InitWithHeaders {\n    init ??= {}\n    init.headers ??= {}\n    init.headers['accept'] ??= 'application/json'\n\n    if (init.credentials === 'include' && init.headers['authorization'] === undefined) {\n      if (this.challenge === null)\n        throw new Error('Credentials must be set before sending authenticated request')\n\n      init.headers['authorization'] = this.challenge\n      delete init.credentials // no cookies\n    }\n\n    if (init.body !== undefined)\n      if (init.body instanceof File || init.body instanceof ReadableStream) {\n        init.method ??= 'POST'\n        init.duplex = 'half'\n        init.headers['content-type'] ??= (init.body as File).type ?? 'application/octet-stream'\n      } else {\n        init.body = JSON.stringify(init.body)\n        init.headers['content-type'] ??= 'application/json'\n      }\n\n    return init as InitWithHeaders\n  }\n\n  private async request(path: string, init: Init): Promise<Response> {\n    const url = new URL(path, this.origin)\n    const response = await this.fetch(url.href, init)\n\n    const challenge = response.headers.get('authorization')\n\n    if (challenge !== null) {\n      this.challenge = challenge\n      this.events.emit('challenge', challenge)\n    }\n\n    return response\n  }\n}\n\ninterface Options {\n  origin: string\n  events: Emitter<Events>\n}\n\ninterface Init extends Omit<RequestInit, 'path' | 'headers'> {\n  duplex?: 'half'\n  body?: any\n  headers?: Record<string, string>\n}\n\ninterface InitWithHeaders extends Init {\n  headers: Record<string, string>\n}\n\ntype Fetch = typeof fetch\n\nexport { Agent }\nexport type { Init }\n","import type { Agent, Init } from './Agent'\nimport type { GenericError } from './Error'\nimport type { Faulty, OctetsEntry } from './Octets'\nimport type { Emitter } from 'mitt'\n\nclass Resource<T = unknown, E extends GenericError = GenericError> {\n  private readonly agent: Agent\n  private readonly path: string\n\n  public constructor(options: Options) {\n    this.agent = options.agent\n    this.path = options.path\n  }\n\n  public async json<R = T, F extends E = E>(rel: string = '', init?: Init): Promise<R | F> {\n    const abs = this.abs(rel)\n\n    return await this.agent.json<R, F>(abs, init)\n  }\n\n  public async octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel: string = '', init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F> {\n    const abs = this.abs(rel)\n\n    return await this.agent.octets<T, F>(abs, init)\n  }\n\n  private abs(rel: string): string {\n    const base = new URL(this.path, 'uri://void')\n    const url = new URL(rel, base)\n\n    if (!url.pathname.endsWith('/'))\n      url.pathname += '/'\n\n    return url.pathname + url.search\n  }\n}\n\ninterface Options {\n  agent: Agent\n  path: string\n}\n\nexport { Resource }\n"],"mappings":"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","names":["import_mitt","mitt","fetch","mitt","fetch"]}
+{"version":3,"sources":["../source/index.ts","../source/Origin.ts","../source/Agent.ts","../source/Resource.ts"],"sourcesContent":["export { connect } from './Origin'\nexport type { GenericError } from './Error'\nexport type { OctetsEntry, WorkflowStep } from './Octets'\nexport type { RequestOptions } from './Agent'\n","import mitt from 'mitt'\nimport { Agent } from './Agent'\nimport { Resource } from './Resource'\nimport type { RequestOptions } from './Agent'\nimport type { Events } from './Events'\nimport type { Emitter } from 'mitt'\n\n/** Resoruce factory */\nclass Origin {\n  public readonly events: Emitter<Events>\n  private readonly agent: Agent\n\n  constructor(options: Options) {\n    this.events = mitt<Events>()\n\n    this.agent = new Agent({\n      origin: options.origin,\n      events: this.events,\n    })\n  }\n\n  public resource<T = unknown>(path: string, init?: Partial<RequestOptions>) {\n    return new Resource<T>({\n      agent: this.agent,\n      path,\n      init,\n    })\n  }\n\n  public authenticate(challenge: string | null) {\n    this.agent.authenticate(challenge)\n  }\n\n  public use(fetch: Fetch) {\n    this.agent.use(fetch)\n  }\n}\n\nfunction connect(options: Options) {\n  return new Origin(options)\n}\n\ninterface Options {\n  origin: string\n}\n\ntype Fetch = typeof fetch\n\nexport { connect }\n","import { Err } from 'error-value'\nimport { meros } from 'meros/browser'\nimport mitt from 'mitt'\nimport type { GenericError } from './Error'\nimport type { Events } from './Events'\nimport type { Faulty, OctetsEntry, WorkflowStep } from './Octets'\nimport type { Emitter } from 'mitt'\n\nclass Agent {\n  private readonly origin: string\n  private readonly events: Emitter<Events>\n  private fetch: Fetch = fetch\n\n  private challenge: string | null = null\n\n  constructor(options: Options) {\n    this.origin = options.origin\n    this.events = options.events\n  }\n\n  public async json<T, E extends GenericError = GenericError>(path: string, init?: RequestOptions): Promise<T | E> {\n    const options = this.setup(init)\n    const response = await this.request(path, options)\n\n    const body = response.headers.get('content-type') === 'application/json'\n      ? await response.json()\n      : await response.text()\n\n    if (response.ok)\n      return body as T\n    else {\n      this.events.emit('error', { code: response.status, body })\n\n      return new Err(response.status, body) as E\n    }\n  }\n\n  public async multipart<T = unknown>(path: string, init?: RequestOptions): Promise<AsyncGenerator<T, void, undefined> | GenericError> {\n    const options = this.setup(init)\n    const response = await this.request(path, options)\n\n    if (!response.ok)\n      return new Err(response.status, await response.json())\n\n    const generator = await meros(response) as AsyncGenerator<{ body: string }>\n    const ack = await generator.next()\n\n    if (JSON.parse(ack.value.body) !== 'ACK') throw new Error('No ACK')\n\n    return (async function * () {\n      for await (const chunk of generator) {\n        const value = JSON.parse(chunk.body)\n\n        if (value === 'FIN') return\n\n        yield value\n      }\n    })()\n  }\n\n  public async octets<\n    T extends Record<string, unknown> = Record<string, unknown>,\n    E extends GenericError = GenericError\n  >(path: string, init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E> {\n    const generator = await this.multipart<OctetsEntry | WorkflowStep>(path, init)\n\n    if (generator instanceof Error) return generator as E\n\n    const chunk = await generator.next()\n    const entry = chunk.value as OctetsEntry\n    const emitter = mitt<Faulty<T>>()\n\n    void (async () => {\n      for await (const part of (generator as AsyncGenerator<WorkflowStep>)) {\n        const payload =\n          part.status === 'completed'\n            ? part.output\n            : new Err(part.error?.code ?? 'UNKNOWN', part.error?.message)\n\n        emitter.emit(part.step, payload as T[typeof part.step])\n      }\n\n      emitter.off('*')\n    })()\n\n    return [entry, emitter]\n  }\n\n  public authenticate(challenge: string | null) {\n    this.challenge = challenge\n  }\n\n  public use(fetch: Fetch) {\n    this.fetch = fetch\n  }\n\n  private setup(init?: RequestOptions): InitWithHeaders {\n    init ??= {}\n    init.headers ??= {}\n    init.headers['accept'] ??= 'application/json'\n\n    if (init.credentials === 'include' && init.headers['authorization'] === undefined) {\n      if (this.challenge === null)\n        throw new Error('Credentials must be set before sending authenticated request')\n\n      init.headers['authorization'] = this.challenge\n      delete init.credentials // no cookies\n    }\n\n    if (init.body !== undefined)\n      if (init.body instanceof File || init.body instanceof ReadableStream) {\n        init.method ??= 'POST'\n        init.duplex = 'half'\n        init.headers['content-type'] ??= (init.body as File).type ?? 'application/octet-stream'\n      } else {\n        init.body = JSON.stringify(init.body)\n        init.headers['content-type'] ??= 'application/json'\n      }\n\n    return init as InitWithHeaders\n  }\n\n  private async request(path: string, init: RequestOptions): Promise<Response> {\n    const url = new URL(path, this.origin)\n    const response = await this.fetch(url.href, init)\n\n    const challenge = response.headers.get('authorization')\n\n    if (challenge !== null) {\n      this.challenge = challenge\n      this.events.emit('challenge', challenge)\n    }\n\n    return response\n  }\n}\n\ninterface Options {\n  origin: string\n  events: Emitter<Events>\n}\n\ninterface RequestOptions extends Omit<RequestInit, 'path' | 'headers'> {\n  duplex?: 'half'\n  body?: any\n  headers?: Record<string, string>\n}\n\ninterface InitWithHeaders extends RequestOptions {\n  headers: Record<string, string>\n}\n\ntype Fetch = typeof fetch\n\nexport { Agent }\nexport type { RequestOptions }\n","import type { Agent, RequestOptions } from './Agent'\nimport type { GenericError } from './Error'\nimport type { Faulty, OctetsEntry } from './Octets'\nimport type { Emitter } from 'mitt'\n\nclass Resource<T = unknown, E extends GenericError = GenericError> {\n  private readonly agent: Agent\n  private readonly path: string\n  private readonly init?: Partial<RequestOptions>\n\n  public constructor(options: Options) {\n    this.agent = options.agent\n    this.path = options.path\n    this.init = options.init\n  }\n\n  public async json<R = T, F extends E = E>(rel: string = '', init?: RequestOptions): Promise<R | F> {\n    const abs = this.abs(rel)\n    const options = Object.assign({}, this.init, init)\n\n    return await this.agent.json<R, F>(abs, options)\n  }\n\n  public async octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel: string = '', init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F> {\n    const abs = this.abs(rel)\n    const options = Object.assign({}, this.init, init)\n\n    return await this.agent.octets<T, F>(abs, options)\n  }\n\n  private abs(rel: string): string {\n    const base = new URL(this.path, 'uri://void')\n    const url = new URL(rel, base)\n\n    if (!url.pathname.endsWith('/'))\n      url.pathname += '/'\n\n    return url.pathname + url.search\n  }\n}\n\ninterface Options {\n  agent: Agent\n  path: string\n  init?: Partial<RequestOptions>\n}\n\nexport { Resource }\n"],"mappings":"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","names":["import_mitt","mitt","fetch","mitt","fetch"]}

package/dist/index.d.cts

@@ -28,9 +28,9 @@ declare class Agent {
     private fetch;
     private challenge;
     constructor(options: Options$2);
-    json<T, E extends GenericError = GenericError>(path: string, init?: Init): Promise<T | E>;
-    multipart<T = unknown>(path: string, init?: Init): Promise<AsyncGenerator<T, void, undefined> | GenericError>;
-    octets<T extends Record<string, unknown> = Record<string, unknown>, E extends GenericError = GenericError>(path: string, init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E>;
+    json<T, E extends GenericError = GenericError>(path: string, init?: RequestOptions): Promise<T | E>;
+    multipart<T = unknown>(path: string, init?: RequestOptions): Promise<AsyncGenerator<T, void, undefined> | GenericError>;
+    octets<T extends Record<string, unknown> = Record<string, unknown>, E extends GenericError = GenericError>(path: string, init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E>;
     authenticate(challenge: string | null): void;
     use(fetch: Fetch$1): void;
     private setup;
@@ -40,7 +40,7 @@ interface Options$2 {
     origin: string;
     events: Emitter<Events>;
 }
-interface Init extends Omit<RequestInit, 'path' | 'headers'> {
+interface RequestOptions extends Omit<RequestInit, 'path' | 'headers'> {
     duplex?: 'half';
     body?: any;
     headers?: Record<string, string>;
@@ -50,14 +50,16 @@ type Fetch$1 = typeof fetch;
 declare class Resource<T = unknown, E extends GenericError = GenericError> {
     private readonly agent;
     private readonly path;
+    private readonly init?;
     constructor(options: Options$1);
-    json<R = T, F extends E = E>(rel?: string, init?: Init): Promise<R | F>;
-    octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel?: string, init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F>;
+    json<R = T, F extends E = E>(rel?: string, init?: RequestOptions): Promise<R | F>;
+    octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel?: string, init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F>;
     private abs;
 }
 interface Options$1 {
     agent: Agent;
     path: string;
+    init?: Partial<RequestOptions>;
 }
 
 /** Resoruce factory */
@@ -65,7 +67,7 @@ declare class Origin {
     readonly events: Emitter<Events>;
     private readonly agent;
     constructor(options: Options);
-    resource<T = unknown>(path: string): Resource<T, GenericError>;
+    resource<T = unknown>(path: string, init?: Partial<RequestOptions>): Resource<T, GenericError>;
     authenticate(challenge: string | null): void;
     use(fetch: Fetch): void;
 }
@@ -75,4 +77,4 @@ interface Options {
 }
 type Fetch = typeof fetch;
 
-export { type GenericError, type OctetsEntry, type WorkflowStep, connect };
+export { type GenericError, type OctetsEntry, type RequestOptions, type WorkflowStep, connect };

package/dist/index.d.ts

@@ -28,9 +28,9 @@ declare class Agent {
     private fetch;
     private challenge;
     constructor(options: Options$2);
-    json<T, E extends GenericError = GenericError>(path: string, init?: Init): Promise<T | E>;
-    multipart<T = unknown>(path: string, init?: Init): Promise<AsyncGenerator<T, void, undefined> | GenericError>;
-    octets<T extends Record<string, unknown> = Record<string, unknown>, E extends GenericError = GenericError>(path: string, init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E>;
+    json<T, E extends GenericError = GenericError>(path: string, init?: RequestOptions): Promise<T | E>;
+    multipart<T = unknown>(path: string, init?: RequestOptions): Promise<AsyncGenerator<T, void, undefined> | GenericError>;
+    octets<T extends Record<string, unknown> = Record<string, unknown>, E extends GenericError = GenericError>(path: string, init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E>;
     authenticate(challenge: string | null): void;
     use(fetch: Fetch$1): void;
     private setup;
@@ -40,7 +40,7 @@ interface Options$2 {
     origin: string;
     events: Emitter<Events>;
 }
-interface Init extends Omit<RequestInit, 'path' | 'headers'> {
+interface RequestOptions extends Omit<RequestInit, 'path' | 'headers'> {
     duplex?: 'half';
     body?: any;
     headers?: Record<string, string>;
@@ -50,14 +50,16 @@ type Fetch$1 = typeof fetch;
 declare class Resource<T = unknown, E extends GenericError = GenericError> {
     private readonly agent;
     private readonly path;
+    private readonly init?;
     constructor(options: Options$1);
-    json<R = T, F extends E = E>(rel?: string, init?: Init): Promise<R | F>;
-    octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel?: string, init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F>;
+    json<R = T, F extends E = E>(rel?: string, init?: RequestOptions): Promise<R | F>;
+    octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel?: string, init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F>;
     private abs;
 }
 interface Options$1 {
     agent: Agent;
     path: string;
+    init?: Partial<RequestOptions>;
 }
 
 /** Resoruce factory */
@@ -65,7 +67,7 @@ declare class Origin {
     readonly events: Emitter<Events>;
     private readonly agent;
     constructor(options: Options);
-    resource<T = unknown>(path: string): Resource<T, GenericError>;
+    resource<T = unknown>(path: string, init?: Partial<RequestOptions>): Resource<T, GenericError>;
     authenticate(challenge: string | null): void;
     use(fetch: Fetch): void;
 }
@@ -75,4 +77,4 @@ interface Options {
 }
 type Fetch = typeof fetch;
 
-export { type GenericError, type OctetsEntry, type WorkflowStep, connect };
+export { type GenericError, type OctetsEntry, type RequestOptions, type WorkflowStep, connect };

package/dist/index.js

@@ -99,17 +99,21 @@ var Agent = class {
 var Resource = class {
   agent;
   path;
+  init;
   constructor(options) {
     this.agent = options.agent;
     this.path = options.path;
+    this.init = options.init;
   }
   async json(rel = "", init) {
     const abs = this.abs(rel);
-    return await this.agent.json(abs, init);
+    const options = Object.assign({}, this.init, init);
+    return await this.agent.json(abs, options);
   }
   async octets(rel = "", init) {
     const abs = this.abs(rel);
-    return await this.agent.octets(abs, init);
+    const options = Object.assign({}, this.init, init);
+    return await this.agent.octets(abs, options);
   }
   abs(rel) {
     const base = new URL(this.path, "uri://void");
@@ -131,10 +135,11 @@ var Origin = class {
       events: this.events
     });
   }
-  resource(path) {
+  resource(path, init) {
     return new Resource({
       agent: this.agent,
-      path
+      path,
+      init
     });
   }
   authenticate(challenge) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/Origin.ts","../source/Agent.ts","../source/Resource.ts"],"sourcesContent":["import mitt from 'mitt'\nimport { Agent } from './Agent'\nimport { Resource } from './Resource'\nimport type { Events } from './Events'\nimport type { Emitter } from 'mitt'\n\n/** Resoruce factory */\nclass Origin {\n  public readonly events: Emitter<Events>\n  private readonly agent: Agent\n\n  constructor(options: Options) {\n    this.events = mitt<Events>()\n\n    this.agent = new Agent({\n      origin: options.origin,\n      events: this.events,\n    })\n  }\n\n  public resource<T = unknown>(path: string) {\n    return new Resource<T>({\n      agent: this.agent,\n      path,\n    })\n  }\n\n  public authenticate(challenge: string | null) {\n    this.agent.authenticate(challenge)\n  }\n\n  public use(fetch: Fetch) {\n    this.agent.use(fetch)\n  }\n}\n\nfunction connect(options: Options) {\n  return new Origin(options)\n}\n\ninterface Options {\n  origin: string\n}\n\ntype Fetch = typeof fetch\n\nexport { connect }\n","import { Err } from 'error-value'\nimport { meros } from 'meros/browser'\nimport mitt from 'mitt'\nimport type { GenericError } from './Error'\nimport type { Events } from './Events'\nimport type { Faulty, OctetsEntry, WorkflowStep } from './Octets'\nimport type { Emitter } from 'mitt'\n\nclass Agent {\n  private readonly origin: string\n  private readonly events: Emitter<Events>\n  private fetch: Fetch = fetch\n\n  private challenge: string | null = null\n\n  constructor(options: Options) {\n    this.origin = options.origin\n    this.events = options.events\n  }\n\n  public async json<T, E extends GenericError = GenericError>(path: string, init?: Init): Promise<T | E> {\n    const options = this.setup(init)\n    const response = await this.request(path, options)\n\n    const body = response.headers.get('content-type') === 'application/json'\n      ? await response.json()\n      : await response.text()\n\n    if (response.ok)\n      return body as T\n    else {\n      this.events.emit('error', { code: response.status, body })\n\n      return new Err(response.status, body) as E\n    }\n  }\n\n  public async multipart<T = unknown>(path: string, init?: Init): Promise<AsyncGenerator<T, void, undefined> | GenericError> {\n    const options = this.setup(init)\n    const response = await this.request(path, options)\n\n    if (!response.ok)\n      return new Err(response.status, await response.json())\n\n    const generator = await meros(response) as AsyncGenerator<{ body: string }>\n    const ack = await generator.next()\n\n    if (JSON.parse(ack.value.body) !== 'ACK') throw new Error('No ACK')\n\n    return (async function * () {\n      for await (const chunk of generator) {\n        const value = JSON.parse(chunk.body)\n\n        if (value === 'FIN') return\n\n        yield value\n      }\n    })()\n  }\n\n  public async octets<\n    T extends Record<string, unknown> = Record<string, unknown>,\n    E extends GenericError = GenericError\n  >(path: string, init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E> {\n    const generator = await this.multipart<OctetsEntry | WorkflowStep>(path, init)\n\n    if (generator instanceof Error) return generator as E\n\n    const chunk = await generator.next()\n    const entry = chunk.value as OctetsEntry\n    const emitter = mitt<Faulty<T>>()\n\n    void (async () => {\n      for await (const part of (generator as AsyncGenerator<WorkflowStep>)) {\n        const payload =\n          part.status === 'completed'\n            ? part.output\n            : new Err(part.error?.code ?? 'UNKNOWN', part.error?.message)\n\n        emitter.emit(part.step, payload as T[typeof part.step])\n      }\n\n      emitter.off('*')\n    })()\n\n    return [entry, emitter]\n  }\n\n  public authenticate(challenge: string | null) {\n    this.challenge = challenge\n  }\n\n  public use(fetch: Fetch) {\n    this.fetch = fetch\n  }\n\n  private setup(init?: Init): InitWithHeaders {\n    init ??= {}\n    init.headers ??= {}\n    init.headers['accept'] ??= 'application/json'\n\n    if (init.credentials === 'include' && init.headers['authorization'] === undefined) {\n      if (this.challenge === null)\n        throw new Error('Credentials must be set before sending authenticated request')\n\n      init.headers['authorization'] = this.challenge\n      delete init.credentials // no cookies\n    }\n\n    if (init.body !== undefined)\n      if (init.body instanceof File || init.body instanceof ReadableStream) {\n        init.method ??= 'POST'\n        init.duplex = 'half'\n        init.headers['content-type'] ??= (init.body as File).type ?? 'application/octet-stream'\n      } else {\n        init.body = JSON.stringify(init.body)\n        init.headers['content-type'] ??= 'application/json'\n      }\n\n    return init as InitWithHeaders\n  }\n\n  private async request(path: string, init: Init): Promise<Response> {\n    const url = new URL(path, this.origin)\n    const response = await this.fetch(url.href, init)\n\n    const challenge = response.headers.get('authorization')\n\n    if (challenge !== null) {\n      this.challenge = challenge\n      this.events.emit('challenge', challenge)\n    }\n\n    return response\n  }\n}\n\ninterface Options {\n  origin: string\n  events: Emitter<Events>\n}\n\ninterface Init extends Omit<RequestInit, 'path' | 'headers'> {\n  duplex?: 'half'\n  body?: any\n  headers?: Record<string, string>\n}\n\ninterface InitWithHeaders extends Init {\n  headers: Record<string, string>\n}\n\ntype Fetch = typeof fetch\n\nexport { Agent }\nexport type { Init }\n","import type { Agent, Init } from './Agent'\nimport type { GenericError } from './Error'\nimport type { Faulty, OctetsEntry } from './Octets'\nimport type { Emitter } from 'mitt'\n\nclass Resource<T = unknown, E extends GenericError = GenericError> {\n  private readonly agent: Agent\n  private readonly path: string\n\n  public constructor(options: Options) {\n    this.agent = options.agent\n    this.path = options.path\n  }\n\n  public async json<R = T, F extends E = E>(rel: string = '', init?: Init): Promise<R | F> {\n    const abs = this.abs(rel)\n\n    return await this.agent.json<R, F>(abs, init)\n  }\n\n  public async octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel: string = '', init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F> {\n    const abs = this.abs(rel)\n\n    return await this.agent.octets<T, F>(abs, init)\n  }\n\n  private abs(rel: string): string {\n    const base = new URL(this.path, 'uri://void')\n    const url = new URL(rel, base)\n\n    if (!url.pathname.endsWith('/'))\n      url.pathname += '/'\n\n    return url.pathname + url.search\n  }\n}\n\ninterface Options {\n  agent: Agent\n  path: string\n}\n\nexport { Resource }\n"],"mappings":"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","names":["mitt","fetch","mitt","fetch"]}
+{"version":3,"sources":["../source/Origin.ts","../source/Agent.ts","../source/Resource.ts"],"sourcesContent":["import mitt from 'mitt'\nimport { Agent } from './Agent'\nimport { Resource } from './Resource'\nimport type { RequestOptions } from './Agent'\nimport type { Events } from './Events'\nimport type { Emitter } from 'mitt'\n\n/** Resoruce factory */\nclass Origin {\n  public readonly events: Emitter<Events>\n  private readonly agent: Agent\n\n  constructor(options: Options) {\n    this.events = mitt<Events>()\n\n    this.agent = new Agent({\n      origin: options.origin,\n      events: this.events,\n    })\n  }\n\n  public resource<T = unknown>(path: string, init?: Partial<RequestOptions>) {\n    return new Resource<T>({\n      agent: this.agent,\n      path,\n      init,\n    })\n  }\n\n  public authenticate(challenge: string | null) {\n    this.agent.authenticate(challenge)\n  }\n\n  public use(fetch: Fetch) {\n    this.agent.use(fetch)\n  }\n}\n\nfunction connect(options: Options) {\n  return new Origin(options)\n}\n\ninterface Options {\n  origin: string\n}\n\ntype Fetch = typeof fetch\n\nexport { connect }\n","import { Err } from 'error-value'\nimport { meros } from 'meros/browser'\nimport mitt from 'mitt'\nimport type { GenericError } from './Error'\nimport type { Events } from './Events'\nimport type { Faulty, OctetsEntry, WorkflowStep } from './Octets'\nimport type { Emitter } from 'mitt'\n\nclass Agent {\n  private readonly origin: string\n  private readonly events: Emitter<Events>\n  private fetch: Fetch = fetch\n\n  private challenge: string | null = null\n\n  constructor(options: Options) {\n    this.origin = options.origin\n    this.events = options.events\n  }\n\n  public async json<T, E extends GenericError = GenericError>(path: string, init?: RequestOptions): Promise<T | E> {\n    const options = this.setup(init)\n    const response = await this.request(path, options)\n\n    const body = response.headers.get('content-type') === 'application/json'\n      ? await response.json()\n      : await response.text()\n\n    if (response.ok)\n      return body as T\n    else {\n      this.events.emit('error', { code: response.status, body })\n\n      return new Err(response.status, body) as E\n    }\n  }\n\n  public async multipart<T = unknown>(path: string, init?: RequestOptions): Promise<AsyncGenerator<T, void, undefined> | GenericError> {\n    const options = this.setup(init)\n    const response = await this.request(path, options)\n\n    if (!response.ok)\n      return new Err(response.status, await response.json())\n\n    const generator = await meros(response) as AsyncGenerator<{ body: string }>\n    const ack = await generator.next()\n\n    if (JSON.parse(ack.value.body) !== 'ACK') throw new Error('No ACK')\n\n    return (async function * () {\n      for await (const chunk of generator) {\n        const value = JSON.parse(chunk.body)\n\n        if (value === 'FIN') return\n\n        yield value\n      }\n    })()\n  }\n\n  public async octets<\n    T extends Record<string, unknown> = Record<string, unknown>,\n    E extends GenericError = GenericError\n  >(path: string, init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E> {\n    const generator = await this.multipart<OctetsEntry | WorkflowStep>(path, init)\n\n    if (generator instanceof Error) return generator as E\n\n    const chunk = await generator.next()\n    const entry = chunk.value as OctetsEntry\n    const emitter = mitt<Faulty<T>>()\n\n    void (async () => {\n      for await (const part of (generator as AsyncGenerator<WorkflowStep>)) {\n        const payload =\n          part.status === 'completed'\n            ? part.output\n            : new Err(part.error?.code ?? 'UNKNOWN', part.error?.message)\n\n        emitter.emit(part.step, payload as T[typeof part.step])\n      }\n\n      emitter.off('*')\n    })()\n\n    return [entry, emitter]\n  }\n\n  public authenticate(challenge: string | null) {\n    this.challenge = challenge\n  }\n\n  public use(fetch: Fetch) {\n    this.fetch = fetch\n  }\n\n  private setup(init?: RequestOptions): InitWithHeaders {\n    init ??= {}\n    init.headers ??= {}\n    init.headers['accept'] ??= 'application/json'\n\n    if (init.credentials === 'include' && init.headers['authorization'] === undefined) {\n      if (this.challenge === null)\n        throw new Error('Credentials must be set before sending authenticated request')\n\n      init.headers['authorization'] = this.challenge\n      delete init.credentials // no cookies\n    }\n\n    if (init.body !== undefined)\n      if (init.body instanceof File || init.body instanceof ReadableStream) {\n        init.method ??= 'POST'\n        init.duplex = 'half'\n        init.headers['content-type'] ??= (init.body as File).type ?? 'application/octet-stream'\n      } else {\n        init.body = JSON.stringify(init.body)\n        init.headers['content-type'] ??= 'application/json'\n      }\n\n    return init as InitWithHeaders\n  }\n\n  private async request(path: string, init: RequestOptions): Promise<Response> {\n    const url = new URL(path, this.origin)\n    const response = await this.fetch(url.href, init)\n\n    const challenge = response.headers.get('authorization')\n\n    if (challenge !== null) {\n      this.challenge = challenge\n      this.events.emit('challenge', challenge)\n    }\n\n    return response\n  }\n}\n\ninterface Options {\n  origin: string\n  events: Emitter<Events>\n}\n\ninterface RequestOptions extends Omit<RequestInit, 'path' | 'headers'> {\n  duplex?: 'half'\n  body?: any\n  headers?: Record<string, string>\n}\n\ninterface InitWithHeaders extends RequestOptions {\n  headers: Record<string, string>\n}\n\ntype Fetch = typeof fetch\n\nexport { Agent }\nexport type { RequestOptions }\n","import type { Agent, RequestOptions } from './Agent'\nimport type { GenericError } from './Error'\nimport type { Faulty, OctetsEntry } from './Octets'\nimport type { Emitter } from 'mitt'\n\nclass Resource<T = unknown, E extends GenericError = GenericError> {\n  private readonly agent: Agent\n  private readonly path: string\n  private readonly init?: Partial<RequestOptions>\n\n  public constructor(options: Options) {\n    this.agent = options.agent\n    this.path = options.path\n    this.init = options.init\n  }\n\n  public async json<R = T, F extends E = E>(rel: string = '', init?: RequestOptions): Promise<R | F> {\n    const abs = this.abs(rel)\n    const options = Object.assign({}, this.init, init)\n\n    return await this.agent.json<R, F>(abs, options)\n  }\n\n  public async octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel: string = '', init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F> {\n    const abs = this.abs(rel)\n    const options = Object.assign({}, this.init, init)\n\n    return await this.agent.octets<T, F>(abs, options)\n  }\n\n  private abs(rel: string): string {\n    const base = new URL(this.path, 'uri://void')\n    const url = new URL(rel, base)\n\n    if (!url.pathname.endsWith('/'))\n      url.pathname += '/'\n\n    return url.pathname + url.search\n  }\n}\n\ninterface Options {\n  agent: Agent\n  path: string\n  init?: Partial<RequestOptions>\n}\n\nexport { Resource }\n"],"mappings":"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","names":["mitt","fetch","mitt","fetch"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/origin",
-  "version": "1.3.4",
+  "version": "1.5.0",
   "publishConfig": {
     "access": "public"
   },

package/source/Agent.ts

@@ -18,7 +18,7 @@ class Agent {
     this.events = options.events
   }
 
-  public async json<T, E extends GenericError = GenericError>(path: string, init?: Init): Promise<T | E> {
+  public async json<T, E extends GenericError = GenericError>(path: string, init?: RequestOptions): Promise<T | E> {
     const options = this.setup(init)
     const response = await this.request(path, options)
 
@@ -35,7 +35,7 @@ class Agent {
     }
   }
 
-  public async multipart<T = unknown>(path: string, init?: Init): Promise<AsyncGenerator<T, void, undefined> | GenericError> {
+  public async multipart<T = unknown>(path: string, init?: RequestOptions): Promise<AsyncGenerator<T, void, undefined> | GenericError> {
     const options = this.setup(init)
     const response = await this.request(path, options)
 
@@ -61,7 +61,7 @@ class Agent {
   public async octets<
     T extends Record<string, unknown> = Record<string, unknown>,
     E extends GenericError = GenericError
-  >(path: string, init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E> {
+  >(path: string, init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | E> {
     const generator = await this.multipart<OctetsEntry | WorkflowStep>(path, init)
 
     if (generator instanceof Error) return generator as E
@@ -94,7 +94,7 @@ class Agent {
     this.fetch = fetch
   }
 
-  private setup(init?: Init): InitWithHeaders {
+  private setup(init?: RequestOptions): InitWithHeaders {
     init ??= {}
     init.headers ??= {}
     init.headers['accept'] ??= 'application/json'
@@ -120,7 +120,7 @@ class Agent {
     return init as InitWithHeaders
   }
 
-  private async request(path: string, init: Init): Promise<Response> {
+  private async request(path: string, init: RequestOptions): Promise<Response> {
     const url = new URL(path, this.origin)
     const response = await this.fetch(url.href, init)
 
@@ -140,17 +140,17 @@ interface Options {
   events: Emitter<Events>
 }
 
-interface Init extends Omit<RequestInit, 'path' | 'headers'> {
+interface RequestOptions extends Omit<RequestInit, 'path' | 'headers'> {
   duplex?: 'half'
   body?: any
   headers?: Record<string, string>
 }
 
-interface InitWithHeaders extends Init {
+interface InitWithHeaders extends RequestOptions {
   headers: Record<string, string>
 }
 
 type Fetch = typeof fetch
 
 export { Agent }
-export type { Init }
+export type { RequestOptions }

package/source/Origin.ts

@@ -1,6 +1,7 @@
 import mitt from 'mitt'
 import { Agent } from './Agent'
 import { Resource } from './Resource'
+import type { RequestOptions } from './Agent'
 import type { Events } from './Events'
 import type { Emitter } from 'mitt'
 
@@ -18,10 +19,11 @@ class Origin {
     })
   }
 
-  public resource<T = unknown>(path: string) {
+  public resource<T = unknown>(path: string, init?: Partial<RequestOptions>) {
     return new Resource<T>({
       agent: this.agent,
       path,
+      init,
     })
   }
 

package/source/Resource.ts

@@ -1,4 +1,4 @@
-import type { Agent, Init } from './Agent'
+import type { Agent, RequestOptions } from './Agent'
 import type { GenericError } from './Error'
 import type { Faulty, OctetsEntry } from './Octets'
 import type { Emitter } from 'mitt'
@@ -6,22 +6,26 @@ import type { Emitter } from 'mitt'
 class Resource<T = unknown, E extends GenericError = GenericError> {
   private readonly agent: Agent
   private readonly path: string
+  private readonly init?: Partial<RequestOptions>
 
   public constructor(options: Options) {
     this.agent = options.agent
     this.path = options.path
+    this.init = options.init
   }
 
-  public async json<R = T, F extends E = E>(rel: string = '', init?: Init): Promise<R | F> {
+  public async json<R = T, F extends E = E>(rel: string = '', init?: RequestOptions): Promise<R | F> {
     const abs = this.abs(rel)
+    const options = Object.assign({}, this.init, init)
 
-    return await this.agent.json<R, F>(abs, init)
+    return await this.agent.json<R, F>(abs, options)
   }
 
-  public async octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel: string = '', init?: Init): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F> {
+  public async octets<T extends Record<string, unknown> = Record<string, unknown>, F extends E = E>(rel: string = '', init?: RequestOptions): Promise<[OctetsEntry, Emitter<Faulty<T>>] | F> {
     const abs = this.abs(rel)
+    const options = Object.assign({}, this.init, init)
 
-    return await this.agent.octets<T, F>(abs, init)
+    return await this.agent.octets<T, F>(abs, options)
   }
 
   private abs(rel: string): string {
@@ -38,6 +42,7 @@ class Resource<T = unknown, E extends GenericError = GenericError> {
 interface Options {
   agent: Agent
   path: string
+  init?: Partial<RequestOptions>
 }
 
 export { Resource }

package/source/index.ts

@@ -1,3 +1,4 @@
 export { connect } from './Origin'
 export type { GenericError } from './Error'
 export type { OctetsEntry, WorkflowStep } from './Octets'
+export type { RequestOptions } from './Agent'