@occultist/occultist 0.0.8 → 0.0.9

package/dist/mod.d.ts

@@ -1,3 +1,4 @@
+export * from './types.ts';
 export * from './cache/types.ts';
 export * from './cache/cache.ts';
 export * from './cache/memory.ts';

package/dist/mod.js

@@ -1,3 +1,4 @@
+export * from "./types.js";
 export * from "./cache/types.js";
 export * from "./cache/cache.js";
 export * from "./cache/memory.js";

package/dist/registry.d.ts

@@ -7,6 +7,7 @@ import { IncomingMessage, type ServerResponse } from "node:http";
 import type { Merge } from "./actions/spec.ts";
 import type { ContextState, Middleware } from "./actions/spec.ts";
 import { type CacheOperationResult } from "./mod.ts";
+import type { Extension } from "./types.ts";
 export interface Callable<State extends ContextState = ContextState> {
     method(method: string, name: string, path: string): ActionAuth<State>;
 }
@@ -248,6 +249,18 @@ export declare class Registry<State extends ContextState = ContextState> impleme
      * @returns A NodeJS server response instance.
      */
     handleRequest(req: IncomingMessage, res: ServerResponse): Promise<ServerResponse>;
+    /**
+     * Registers an Occultist extension. This is usually done
+     * by extensions when they are created.
+     *
+     * @param The Occultist extension to register.
+     */
+    registerExtension(extension: Extension): void;
+    /**
+     * Must be called after all Occultist extensions have been registered.
+     * When some of the extensions have async setup tasks.
+     */
+    setupExtensions(): Promise<void>;
     addEventListener(type: RegistryEvents, callback: EventListener): void;
     removeEventListener(type: RegistryEvents, callback: EventListener): void;
 }

package/dist/registry.js

@@ -122,6 +122,7 @@ export class Registry {
     #middleware = [];
     #actions = null;
     #handlers = null;
+    #extensions = [];
     constructor(args) {
         const url = new URL(args.rootIRI);
         this.#rootIRI = args.rootIRI;
@@ -499,6 +500,32 @@ export class Registry {
             return res;
         }
     }
+    /**
+     * Registers an Occultist extension. This is usually done
+     * by extensions when they are created.
+     *
+     * @param The Occultist extension to register.
+     */
+    registerExtension(extension) {
+        this.#extensions.push(extension);
+    }
+    /**
+     * Must be called after all Occultist extensions have been registered.
+     * When some of the extensions have async setup tasks.
+     */
+    async setupExtensions() {
+        const setupStreams = [];
+        for (let i = 0; i < this.#extensions.length; i++) {
+            if (typeof this.#extensions[i].setup === 'function') {
+                setupStreams.push(this.#extensions[i].setup());
+            }
+        }
+        for (let i = 0; i < setupStreams.length; i++) {
+            for await (const message of setupStreams[i]) {
+                console.log(message);
+            }
+        }
+    }
     addEventListener(type, callback) {
         this.#eventTarget.addEventListener(type, callback);
     }

package/dist/types.d.ts

@@ -1,3 +1,11 @@
+export interface StaticContext {
+    link(alias: string, as: string): string;
+}
+export interface Extension {
+    name: string;
+    setup?(): ReadableStream;
+    createStaticContext?(): StaticContext;
+}
 export type ProblemDetailsParam = {
     name: string;
     reason: string;

package/dist/types.js

@@ -1 +1,2 @@
+;
 export {};

package/lib/mod.ts

@@ -1,3 +1,4 @@
+export * from './types.ts';
 export * from './cache/types.ts';
 export * from './cache/cache.ts';
 export * from './cache/memory.ts';

package/lib/registry.ts

@@ -11,6 +11,7 @@ import type { ContextState, Middleware } from "./actions/spec.ts";
 import {ProblemDetailsError} from "./errors.ts"
 import {WrappedRequest} from "./request.ts";
 import {type CacheOperationResult} from "./mod.ts";
+import type {Extension} from "./types.ts";
 
 
 export interface Callable<
@@ -187,6 +188,7 @@ export class Registry<
   #middleware: Middleware[] = [];
   #actions: ImplementedAction[] | null = null;
   #handlers: HandlerDefinition[] | null = null;
+  #extensions: Extension[] = [];
 
   constructor(args: RegistryArgs) {
     const url = new URL(args.rootIRI);
@@ -731,6 +733,36 @@ export class Registry<
     }
   }
 
+  /**
+   * Registers an Occultist extension. This is usually done
+   * by extensions when they are created.
+   *
+   * @param The Occultist extension to register.
+   */
+  registerExtension(extension: Extension): void {
+    this.#extensions.push(extension);
+  }
+
+  /**
+   * Must be called after all Occultist extensions have been registered.
+   * When some of the extensions have async setup tasks.
+   */
+  async setupExtensions(): Promise<void> {
+    const setupStreams: ReadableStream[] = [];
+
+    for (let i = 0; i < this.#extensions.length; i++) {
+      if (typeof this.#extensions[i].setup === 'function') {
+        setupStreams.push(this.#extensions[i].setup());
+      }
+    }
+
+    for (let i = 0; i < setupStreams.length; i++) {
+      for await (const message of setupStreams[i]) {
+        console.log(message);
+      }
+    }
+  }
+
   addEventListener(type: RegistryEvents, callback: EventListener) {
     this.#eventTarget.addEventListener(type, callback);
   };

package/lib/types.ts

@@ -1,3 +1,14 @@
+
+export interface StaticContext {
+  link(alias: string, as: string): string;
+}
+
+export interface Extension {
+  name: string;
+  setup?(): ReadableStream;
+  createStaticContext?(): StaticContext;
+};
+
 export type ProblemDetailsParam = {
   name: string;
   reason: string;

package/package.json

@@ -35,7 +35,7 @@
     "jsonld": "^9.0.0",
     "typescript": "^5.9.3"
   },
-  "version": "0.0.8",
+  "version": "0.0.9",
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "test": "node --test"