@based/functions 1.1.1 → 1.2.0

package/dist/auth.d.ts

@@ -12,4 +12,4 @@ export type AuthState = {
 export type Authorize = (based: BasedFunctionClient, context: Context<HttpSession | WebSocketSession>, name: string, // name as generic dope
 payload?: any) => Promise<boolean>;
 export type VerifyAuthState = (based: BasedFunctionClient, context: Context<HttpSession | WebSocketSession>, authState: AuthState) => Promise<true | AuthState>;
-export type AuthorizeConnection = (based: BasedFunctionClient, req: HttpRequest) => Promise<boolean>;
+export type AuthorizeConnection = (based: BasedFunctionClient, req: HttpRequest, ip: string) => Promise<boolean>;

package/dist/client.d.ts

@@ -3,12 +3,15 @@ import { BasedChannel } from './channel';
 import { Context } from './context';
 import { BasedQuery } from './query';
 import { StreamFunctionOpts } from './stream';
+import { Geo } from './geo';
 export declare abstract class BasedFunctionClient {
     server: any;
+    db: any;
     abstract call(name: string, payload?: any, ctx?: Context): Promise<any>;
     abstract query(name: string, payload?: any): BasedQuery;
     abstract channel(name: string, payload?: any): BasedChannel;
     abstract stream(name: string, payload: StreamFunctionOpts, ctx?: Context): Promise<any>;
     abstract sendAuthState(ctx: Context, authState: AuthState): void;
+    abstract geo(ctx: Context): Promise<Geo>;
     abstract renewAuthState(ctx: Context, authState?: AuthState): Promise<AuthState>;
 }

package/dist/client.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BasedFunctionClient = void 0;
-// TODO: this is the place where we will add extra specifications
 class BasedFunctionClient {
 }
 exports.BasedFunctionClient = BasedFunctionClient;

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAMA,iEAAiE;AACjE,MAAsB,mBAAmB;CAqBxC;AArBD,kDAqBC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAOA,MAAsB,mBAAmB;CAyBxC;AAzBD,kDAyBC"}

package/dist/context.d.ts

@@ -17,6 +17,9 @@ export type WebSocketSession = {
         name: string;
         payload: any;
     }>;
+    headers: {
+        [key: string]: string;
+    };
     unauthorizedChannels?: Set<{
         id: number;
         name: string;
@@ -50,21 +53,33 @@ export type HttpSession = {
 export type InternalSessionObservable = {
     id: number;
     name: string;
+    headers: {
+        [key: string]: string;
+    };
     type: 'query';
 };
 export type InternalSessionChannel = {
     id: number;
     name: string;
+    headers: {
+        [key: string]: string;
+    };
     type: 'channel';
 };
 export type InternalSessionClient = {
     client: BasedFunctionClient;
+    headers: {
+        [key: string]: string;
+    };
     type: 'client';
 };
 export type InternalSession = InternalSessionClient | InternalSessionObservable | InternalSessionChannel;
 export type MinimalExternalSession = {
     ua: string;
     ip: string;
+    headers: {
+        [key: string]: string;
+    };
 };
 export type Session = (WebSocketSession | HttpSession | InternalSession | MinimalExternalSession) & {
     /** Only available in Ws and Http contexts */

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":";;;AAiGO,MAAM,aAAa,GAAG,CAC3B,GAAqB,EACQ,EAAE;IAC/B,IAAI,KAAK,IAAI,GAAG,EAAE,OAAO,EAAE;QACzB,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAPY,QAAA,aAAa,iBAOzB;AAEM,MAAM,WAAW,GAAG,CACzB,GAAqB,EACa,EAAE;IACpC,IAAI,GAAG,CAAC,OAAO,IAAI,IAAA,mBAAW,EAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAC3C,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAPY,QAAA,WAAW,eAOvB;AAEM,MAAM,eAAe,GAAG,CAC7B,GAAqB,EAC2B,EAAE;IAClD,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,IAAA,mBAAW,EAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAA,qBAAa,EAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE;QAC3E,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAPY,QAAA,eAAe,mBAO3B;AAEM,MAAM,aAAa,GAAG,CAAC,OAAgB,EAA0B,EAAE;IACxE,IAAI,KAAK,IAAI,OAAO,EAAE;QACpB,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AALY,QAAA,aAAa,iBAKzB;AAEM,MAAM,WAAW,GAAG,CAAC,OAAgB,EAA+B,EAAE;IAC3E,IAAI,MAAM,IAAI,OAAO,EAAE;QACrB,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AALY,QAAA,WAAW,eAKvB"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":";;;AAsGO,MAAM,aAAa,GAAG,CAC3B,GAAqB,EACQ,EAAE;IAC/B,IAAI,KAAK,IAAI,GAAG,EAAE,OAAO,EAAE;QACzB,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAPY,QAAA,aAAa,iBAOzB;AAEM,MAAM,WAAW,GAAG,CACzB,GAAqB,EACa,EAAE;IACpC,IAAI,GAAG,CAAC,OAAO,IAAI,IAAA,mBAAW,EAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAC3C,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAPY,QAAA,WAAW,eAOvB;AAEM,MAAM,eAAe,GAAG,CAC7B,GAAqB,EAC2B,EAAE;IAClD,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,IAAA,mBAAW,EAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAA,qBAAa,EAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE;QAC3E,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAPY,QAAA,eAAe,mBAO3B;AAEM,MAAM,aAAa,GAAG,CAAC,OAAgB,EAA0B,EAAE;IACxE,IAAI,KAAK,IAAI,OAAO,EAAE;QACpB,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AALY,QAAA,aAAa,iBAKzB;AAEM,MAAM,WAAW,GAAG,CAAC,OAAgB,EAA+B,EAAE;IAC3E,IAAI,MAAM,IAAI,OAAO,EAAE;QACrB,OAAO,IAAI,CAAA;KACZ;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AALY,QAAA,WAAW,eAKvB"}

package/dist/functions.d.ts

@@ -1,6 +1,7 @@
 import { Context, HttpSession } from './context';
 import { BasedFunctionClient } from './client';
 import { BasedDataStream } from './stream';
+import { Authorize } from './auth';
 export type ObservableUpdateFunction<K = any> = {
     (data: K, checksum?: number, diff?: any, fromChecksum?: number, isDeflate?: boolean, rawData?: K, err?: any): void;
     __internalObs__?: true;
@@ -23,7 +24,92 @@ export type StreamPayload<P = any> = {
 export type BasedStreamFunction<P = any, K = any> = BasedFunction<StreamPayload<P>, K>;
 export type BasedQueryFunction<P = any, K = any> = ((based: BasedFunctionClient, payload: P, update: ObservableUpdateFunction<K>, error: ObserveErrorListener) => Promise<() => void>) | ((based: BasedFunctionClient, payload: P, update: ObservableUpdateFunction<K>, error: ObserveErrorListener) => () => void);
 export type BasedChannelFunction<P = any, K = any> = (based: BasedFunctionClient, payload: P, id: number, update: ChannelMessageFunction<K>, error: (err?: any) => void) => () => void;
-export type BasedChannelPublishFunction<P = any, K = any> = (based: BasedFunctionClient, payload: P, message: K, id: number, ctx: Context) => void;
-export type ChannelMessageFunction<K = any> = (message: K) => void;
+export type BasedChannelPublishFunction<P = any, M = any> = (based: BasedFunctionClient, payload: P, message: M, id: number, ctx: Context) => void;
+export type ChannelMessageFunction<M = any> = (message: M) => void;
 export type ChannelMessageFunctionInternal<K = any> = (message: K, err?: any) => void;
 export type UninstallFunction = () => Promise<void>;
+type FunctionConfigShared = {
+    /** Function name */
+    name: string;
+    /** In addition to the name, a function can have a custom path for HTTP requests.
+     * For example: `path: 'my/custom/path'` will result in the function being
+     * available with a request to `env.based.io/my/custom/path`
+     */
+    path?: string;
+    /** In bytes. `-1` indicates no size limit */
+    maxPayloadSize?: number;
+    /** Cost in tokens for this function call.  */
+    rateLimitTokens?: number;
+    /** A function marked as `public` will skip the call to authorize. */
+    public?: boolean;
+    /** Array of headers that this function expects to receive. */
+    headers?: string[];
+    /** A function marked as `internalOnly` will only be accessible from other server side functions,
+     * and not through the public internet.
+     */
+    internalOnly?: boolean;
+    /** Can hold extra information about a spec */
+    data?: any;
+    /** Unistall after idle, in ms */
+    uninstallAfterIdleTime?: number;
+    /** Hook that fires on uninstall of the function e.g. to clean up database connections */
+    uninstall?: UninstallFunction;
+    /** Specific authorize for this function */
+    authorize?: Authorize;
+};
+export type BasedFunctionConfig = ({
+    /** Function type `channel, function, query, stream, authorize` */
+    type: 'channel';
+    /** Channel subscriber
+      
+     ```js
+     const subscribe = (based, payload, id, update) => {
+        let cnt = 0
+        const interval = setInterval(() => {
+          update(++cnt)
+        })
+        return () => clearInterval(cnt)
+     }
+     ```
+    */
+    subscriber?: BasedChannelFunction;
+    /** Channel publisher
+      
+     ```js
+     const publisher = (based, payload, msg, id) => {
+        publishToChannel(id, msg)
+     }
+     ```
+    */
+    publisher?: BasedChannelPublishFunction;
+    /** Makes only the publisher public */
+    publicPublisher?: boolean;
+    name: string;
+    /** How long should the channel subscriber remain active after all subscribers are gone, in ms */
+    closeAfterIdleTime?: number;
+} & FunctionConfigShared) | ({
+    /** Function type `channel, function, query, stream, authorize` */
+    type: 'function';
+    function: BasedFunction;
+    name: string;
+    httpResponse?: HttpResponse;
+} & FunctionConfigShared) | ({
+    /** Function type `channel, function, query, stream, authorize` */
+    type: 'query';
+    function: BasedQueryFunction;
+    name: string;
+    httpResponse?: HttpResponse;
+    /** How long should the query function remain active after all subscribers are gone, in ms */
+    closeAfterIdleTime?: number;
+} & FunctionConfigShared) | ({
+    /** Function type `channel, function, query, stream, authorize` */
+    type: 'stream';
+    function: BasedStreamFunction;
+    name: string;
+} & FunctionConfigShared) | {
+    /** Function type `channel, function, query, stream, authorize` */
+    type: 'authorize';
+    function: Authorize;
+    name: string;
+};
+export {};

package/dist/geo.d.ts

@@ -0,0 +1,35 @@
+export type CountryCode = 'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BQ' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CG' | 'CD' | 'CK' | 'CR' | 'HR' | 'CU' | 'CW' | 'CY' | 'CZ' | 'CI' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MK' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RO' | 'RU' | 'RW' | 'RE' | 'BL' | 'SH' | 'KN' | 'LC' | 'MF' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SX' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'SS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX';
+type Char = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
+export type GeoRegionISO = `${Char}${Char}` | `${Char}${Char}${Char}`;
+export type Geo = {
+    country: CountryCode;
+    /**
+    Ip formatted as ipv6
+  
+    e.g. `2001:0db8:85a3:0000:0000:8a2e:0370:7334`
+    */
+    ip: string;
+    /**
+    Region subdivisions
+  
+    e.g. `[{ iso: 'NH', name: 'north-holland' }]`
+    */
+    regions: {
+        iso: GeoRegionISO;
+        name?: string;
+    }[];
+    lat: number;
+    long: number;
+    /**
+    Accuracy Radius (km)
+    */
+    accuracy: number;
+    /**
+    City name
+  
+    e.g. `Amsterdam`
+    */
+    city?: string;
+    postalCode?: string;
+};
+export {};

package/dist/geo.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=geo.js.map

package/dist/geo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.js","sourceRoot":"","sources":["../src/geo.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -5,3 +5,4 @@ export * from './functions';
 export * from './query';
 export * from './stream';
 export * from './channel';
+export * from './geo';

package/dist/index.js

@@ -21,4 +21,5 @@ __exportStar(require("./functions"), exports);
 __exportStar(require("./query"), exports);
 __exportStar(require("./stream"), exports);
 __exportStar(require("./channel"), exports);
+__exportStar(require("./geo"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,yCAAsB;AACtB,2CAAwB;AACxB,8CAA2B;AAC3B,0CAAuB;AACvB,2CAAwB;AACxB,4CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB;AACzB,yCAAsB;AACtB,2CAAwB;AACxB,8CAA2B;AAC3B,0CAAuB;AACvB,2CAAwB;AACxB,4CAAyB;AACzB,wCAAqB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@based/functions",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "license": "MIT",
   "main": "dist/index.js",
   "scripts": {

package/src/auth.ts

@@ -29,5 +29,6 @@ export type VerifyAuthState = (
 
 export type AuthorizeConnection = (
   based: BasedFunctionClient,
-  req: HttpRequest
+  req: HttpRequest,
+  ip: string
 ) => Promise<boolean>

package/src/client.ts

@@ -3,11 +3,13 @@ import { BasedChannel } from './channel'
 import { Context } from './context'
 import { BasedQuery } from './query'
 import { StreamFunctionOpts } from './stream'
+import { Geo } from './geo'
 
-// TODO: this is the place where we will add extra specifications
 export abstract class BasedFunctionClient {
   server: any
 
+  db: any
+
   abstract call(name: string, payload?: any, ctx?: Context): Promise<any>
 
   abstract query(name: string, payload?: any): BasedQuery
@@ -22,6 +24,8 @@ export abstract class BasedFunctionClient {
 
   abstract sendAuthState(ctx: Context, authState: AuthState): void
 
+  abstract geo(ctx: Context): Promise<Geo>
+
   abstract renewAuthState(
     ctx: Context,
     authState?: AuthState

package/src/context.ts

@@ -19,6 +19,7 @@ export type WebSocketSession = {
     name: string
     payload: any
   }>
+  headers: { [key: string]: string }
   unauthorizedChannels?: Set<{
     id: number
     name: string
@@ -55,17 +56,20 @@ export type HttpSession = {
 export type InternalSessionObservable = {
   id: number
   name: string
+  headers: { [key: string]: string }
   type: 'query'
 }
 
 export type InternalSessionChannel = {
   id: number
   name: string
+  headers: { [key: string]: string }
   type: 'channel'
 }
 
 export type InternalSessionClient = {
   client: BasedFunctionClient
+  headers: { [key: string]: string }
   type: 'client'
 }
 
@@ -79,6 +83,7 @@ export type InternalSession =
 export type MinimalExternalSession = {
   ua: string
   ip: string
+  headers: { [key: string]: string }
 }
 
 export type Session = (

package/src/functions.ts

@@ -1,6 +1,7 @@
 import { Context, HttpSession } from './context'
 import { BasedFunctionClient } from './client'
 import { BasedDataStream } from './stream'
+import { Authorize } from './auth'
 
 export type ObservableUpdateFunction<K = any> = {
   (
@@ -79,15 +80,15 @@ export type BasedChannelFunction<P = any, K = any> = (
   error: (err?: any) => void
 ) => () => void
 
-export type BasedChannelPublishFunction<P = any, K = any> = (
+export type BasedChannelPublishFunction<P = any, M = any> = (
   based: BasedFunctionClient,
   payload: P,
-  message: K,
+  message: M,
   id: number,
   ctx: Context
 ) => void
 
-export type ChannelMessageFunction<K = any> = (message: K) => void
+export type ChannelMessageFunction<M = any> = (message: M) => void
 
 export type ChannelMessageFunctionInternal<K = any> = (
   message: K,
@@ -95,3 +96,94 @@ export type ChannelMessageFunctionInternal<K = any> = (
 ) => void
 
 export type UninstallFunction = () => Promise<void>
+
+type FunctionConfigShared = {
+  /** Function name */
+  name: string
+  /** In addition to the name, a function can have a custom path for HTTP requests.
+   * For example: `path: 'my/custom/path'` will result in the function being
+   * available with a request to `env.based.io/my/custom/path`
+   */
+  path?: string
+  /** In bytes. `-1` indicates no size limit */
+  maxPayloadSize?: number
+  /** Cost in tokens for this function call.  */
+  rateLimitTokens?: number
+  /** A function marked as `public` will skip the call to authorize. */
+  public?: boolean
+  /** Array of headers that this function expects to receive. */
+  headers?: string[]
+  /** A function marked as `internalOnly` will only be accessible from other server side functions,
+   * and not through the public internet.
+   */
+  internalOnly?: boolean
+  /** Can hold extra information about a spec */
+  data?: any
+  /** Unistall after idle, in ms */
+  uninstallAfterIdleTime?: number
+  /** Hook that fires on uninstall of the function e.g. to clean up database connections */
+  uninstall?: UninstallFunction
+  /** Specific authorize for this function */
+  authorize?: Authorize
+}
+
+export type BasedFunctionConfig =
+  | ({
+      /** Function type `channel, function, query, stream, authorize` */
+      type: 'channel'
+      /** Channel subscriber 
+        
+       ```js
+       const subscribe = (based, payload, id, update) => {
+          let cnt = 0
+          const interval = setInterval(() => {
+            update(++cnt)
+          })
+          return () => clearInterval(cnt)
+       }
+       ```
+      */
+      subscriber?: BasedChannelFunction
+      /** Channel publisher 
+        
+       ```js
+       const publisher = (based, payload, msg, id) => {
+          publishToChannel(id, msg)
+       }
+       ```
+      */
+      publisher?: BasedChannelPublishFunction
+      /** Makes only the publisher public */
+      publicPublisher?: boolean
+      name: string
+      /** How long should the channel subscriber remain active after all subscribers are gone, in ms */
+      closeAfterIdleTime?: number
+    } & FunctionConfigShared)
+  | ({
+      /** Function type `channel, function, query, stream, authorize` */
+      type: 'function'
+      function: BasedFunction
+      name: string
+      httpResponse?: HttpResponse
+    } & FunctionConfigShared)
+  | ({
+      /** Function type `channel, function, query, stream, authorize` */
+      type: 'query'
+      function: BasedQueryFunction
+      name: string
+      httpResponse?: HttpResponse
+      /** How long should the query function remain active after all subscribers are gone, in ms */
+      closeAfterIdleTime?: number
+    } & FunctionConfigShared)
+  | ({
+      /** Function type `channel, function, query, stream, authorize` */
+      type: 'stream'
+      function: BasedStreamFunction
+      name: string
+    } & FunctionConfigShared)
+  | {
+      /** Function type `channel, function, query, stream, authorize` */
+      type: 'authorize'
+      function: Authorize
+      name: string
+    }

package/src/geo.ts

@@ -0,0 +1,322 @@
+export type CountryCode =
+  | 'AF'
+  | 'AL'
+  | 'DZ'
+  | 'AS'
+  | 'AD'
+  | 'AO'
+  | 'AI'
+  | 'AQ'
+  | 'AG'
+  | 'AR'
+  | 'AM'
+  | 'AW'
+  | 'AU'
+  | 'AT'
+  | 'AZ'
+  | 'BS'
+  | 'BH'
+  | 'BD'
+  | 'BB'
+  | 'BY'
+  | 'BE'
+  | 'BZ'
+  | 'BJ'
+  | 'BM'
+  | 'BT'
+  | 'BO'
+  | 'BQ'
+  | 'BA'
+  | 'BW'
+  | 'BV'
+  | 'BR'
+  | 'IO'
+  | 'BN'
+  | 'BG'
+  | 'BF'
+  | 'BI'
+  | 'KH'
+  | 'CM'
+  | 'CA'
+  | 'CV'
+  | 'KY'
+  | 'CF'
+  | 'TD'
+  | 'CL'
+  | 'CN'
+  | 'CX'
+  | 'CC'
+  | 'CO'
+  | 'KM'
+  | 'CG'
+  | 'CD'
+  | 'CK'
+  | 'CR'
+  | 'HR'
+  | 'CU'
+  | 'CW'
+  | 'CY'
+  | 'CZ'
+  | 'CI'
+  | 'DK'
+  | 'DJ'
+  | 'DM'
+  | 'DO'
+  | 'EC'
+  | 'EG'
+  | 'SV'
+  | 'GQ'
+  | 'ER'
+  | 'EE'
+  | 'ET'
+  | 'FK'
+  | 'FO'
+  | 'FJ'
+  | 'FI'
+  | 'FR'
+  | 'GF'
+  | 'PF'
+  | 'TF'
+  | 'GA'
+  | 'GM'
+  | 'GE'
+  | 'DE'
+  | 'GH'
+  | 'GI'
+  | 'GR'
+  | 'GL'
+  | 'GD'
+  | 'GP'
+  | 'GU'
+  | 'GT'
+  | 'GG'
+  | 'GN'
+  | 'GW'
+  | 'GY'
+  | 'HT'
+  | 'HM'
+  | 'VA'
+  | 'HN'
+  | 'HK'
+  | 'HU'
+  | 'IS'
+  | 'IN'
+  | 'ID'
+  | 'IR'
+  | 'IQ'
+  | 'IE'
+  | 'IM'
+  | 'IL'
+  | 'IT'
+  | 'JM'
+  | 'JP'
+  | 'JE'
+  | 'JO'
+  | 'KZ'
+  | 'KE'
+  | 'KI'
+  | 'KP'
+  | 'KR'
+  | 'KW'
+  | 'KG'
+  | 'LA'
+  | 'LV'
+  | 'LB'
+  | 'LS'
+  | 'LR'
+  | 'LY'
+  | 'LI'
+  | 'LT'
+  | 'LU'
+  | 'MO'
+  | 'MK'
+  | 'MG'
+  | 'MW'
+  | 'MY'
+  | 'MV'
+  | 'ML'
+  | 'MT'
+  | 'MH'
+  | 'MQ'
+  | 'MR'
+  | 'MU'
+  | 'YT'
+  | 'MX'
+  | 'FM'
+  | 'MD'
+  | 'MC'
+  | 'MN'
+  | 'ME'
+  | 'MS'
+  | 'MA'
+  | 'MZ'
+  | 'MM'
+  | 'NA'
+  | 'NR'
+  | 'NP'
+  | 'NL'
+  | 'NC'
+  | 'NZ'
+  | 'NI'
+  | 'NE'
+  | 'NG'
+  | 'NU'
+  | 'NF'
+  | 'MP'
+  | 'NO'
+  | 'OM'
+  | 'PK'
+  | 'PW'
+  | 'PS'
+  | 'PA'
+  | 'PG'
+  | 'PY'
+  | 'PE'
+  | 'PH'
+  | 'PN'
+  | 'PL'
+  | 'PT'
+  | 'PR'
+  | 'QA'
+  | 'RO'
+  | 'RU'
+  | 'RW'
+  | 'RE'
+  | 'BL'
+  | 'SH'
+  | 'KN'
+  | 'LC'
+  | 'MF'
+  | 'PM'
+  | 'VC'
+  | 'WS'
+  | 'SM'
+  | 'ST'
+  | 'SA'
+  | 'SN'
+  | 'RS'
+  | 'SC'
+  | 'SL'
+  | 'SG'
+  | 'SX'
+  | 'SK'
+  | 'SI'
+  | 'SB'
+  | 'SO'
+  | 'ZA'
+  | 'GS'
+  | 'SS'
+  | 'ES'
+  | 'LK'
+  | 'SD'
+  | 'SR'
+  | 'SJ'
+  | 'SZ'
+  | 'SE'
+  | 'CH'
+  | 'SY'
+  | 'TW'
+  | 'TJ'
+  | 'TZ'
+  | 'TH'
+  | 'TL'
+  | 'TG'
+  | 'TK'
+  | 'TO'
+  | 'TT'
+  | 'TN'
+  | 'TR'
+  | 'TM'
+  | 'TC'
+  | 'TV'
+  | 'UG'
+  | 'UA'
+  | 'AE'
+  | 'GB'
+  | 'US'
+  | 'UM'
+  | 'UY'
+  | 'UZ'
+  | 'VU'
+  | 'VE'
+  | 'VN'
+  | 'VG'
+  | 'VI'
+  | 'WF'
+  | 'EH'
+  | 'YE'
+  | 'ZM'
+  | 'ZW'
+  | 'AX'
+
+type Char =
+  | 'A'
+  | 'B'
+  | 'C'
+  | 'D'
+  | 'E'
+  | 'F'
+  | 'G'
+  | 'H'
+  | 'I'
+  | 'J'
+  | 'K'
+  | 'L'
+  | 'M'
+  | 'N'
+  | 'O'
+  | 'P'
+  | 'Q'
+  | 'R'
+  | 'S'
+  | 'T'
+  | 'U'
+  | 'V'
+  | 'W'
+  | 'X'
+  | 'Y'
+  | 'Z'
+  | '0'
+  | '1'
+  | '2'
+  | '3'
+  | '4'
+  | '5'
+  | '6'
+  | '7'
+  | '8'
+  | '9'
+
+export type GeoRegionISO = `${Char}${Char}` | `${Char}${Char}${Char}`
+
+export type Geo = {
+  country: CountryCode
+  /**
+  Ip formatted as ipv6
+
+  e.g. `2001:0db8:85a3:0000:0000:8a2e:0370:7334`
+  */
+  ip: string
+  /**
+  Region subdivisions
+
+  e.g. `[{ iso: 'NH', name: 'north-holland' }]`
+  */
+  regions: {
+    iso: GeoRegionISO
+    name?: string
+  }[]
+  lat: number
+  long: number
+  /**
+  Accuracy Radius (km)
+  */
+  accuracy: number
+  /**
+  City name 
+
+  e.g. `Amsterdam`
+  */
+  city?: string
+  postalCode?: string
+}

package/src/index.ts

@@ -5,3 +5,4 @@ export * from './functions'
 export * from './query'
 export * from './stream'
 export * from './channel'
+export * from './geo'