@immediately-run/sdk 0.1.0

package/dist/urlUtils.cjs

@@ -0,0 +1,159 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var urlUtils_exports = {};
+__export(urlUtils_exports, {
+  FILES_PREFIX: () => FILES_PREFIX,
+  constructOuterUrl: () => constructOuterUrl,
+  constructUrl: () => constructUrl,
+  getOuterHostname: () => getOuterHostname,
+  getSearchParams: () => getSearchParams,
+  isAbsolutePath: () => isAbsolutePath,
+  isInternalHref: () => isInternalHref,
+  maybeParseUrl: () => maybeParseUrl,
+  parseHref: () => parseHref,
+  parsePath: () => parsePath,
+  parseTarget: () => parseTarget,
+  repositoryPrefixURL: () => repositoryPrefixURL
+});
+module.exports = __toCommonJS(urlUtils_exports);
+var import_pathUtils = require("./pathUtils");
+const FILES_PREFIX = "/files";
+const getOuterHostname = (outerHref) => {
+  const url = new URL(outerHref);
+  return `${url.protocol}//${url.hostname}`;
+};
+const getSearchParams = (search) => Object.fromEntries(
+  [...new URLSearchParams(search ?? window.location.search).entries()]
+);
+const parseTarget = (target, navigation) => {
+  const newNavigation = { ...navigation };
+  let [prehash, hash] = target.split("#");
+  if (prehash) {
+    let [path, search] = prehash.split("?");
+    if (path) {
+      newNavigation.sandboxPath = path;
+    }
+    newNavigation.search = search ? search : "";
+  }
+  newNavigation.hash = hash ? hash : "";
+  return newNavigation;
+};
+const maybeParseUrl = (str) => {
+  try {
+    return new URL(str);
+  } catch (_) {
+    return null;
+  }
+};
+const isAbsolutePath = (sandboxPath) => sandboxPath.startsWith("/");
+const repositoryPrefixURL = (outerHref, navigationState) => constructUrl(outerHref, {
+  ...navigationState,
+  sandboxPath: ""
+});
+const constructOuterUrl = (previousOuterHref, sandboxTarget, navigationState, addFilesPrefix = true) => {
+  if (isAbsolutePath(sandboxTarget)) {
+    return constructUrl(
+      previousOuterHref,
+      {
+        ...navigationState,
+        sandboxPath: addFilesPrefix ? (0, import_pathUtils.joinPaths)(FILES_PREFIX, sandboxTarget) : sandboxTarget
+      }
+    );
+  }
+  return new URL(
+    sandboxTarget,
+    constructUrl(
+      previousOuterHref,
+      navigationState
+    )
+  ).toString();
+};
+const isInternalHref = (outerHref, target, navigationState) => {
+  const parsedUrl = maybeParseUrl(target);
+  if (parsedUrl) {
+    return target.startsWith(repositoryPrefixURL(outerHref, navigationState));
+  }
+  return true;
+};
+const PATH_SEGMENTS = [
+  { name: "mode", pattern: "\\w+" },
+  { name: "provider", pattern: "[a-zA-Z0-9-_]+" },
+  { name: "namespace", pattern: "[a-zA-Z0-9-_]+" },
+  { name: "repository", pattern: "[a-zA-Z0-9-_]+" },
+  { name: "ref", pattern: "[a-zA-Z0-9-_]+" },
+  { name: "sandboxPath", pattern: ".*", transform: (s) => `/${s}` }
+];
+const OUTER_HREF_REGEXP = new RegExp("^" + PATH_SEGMENTS.map(({ name, pattern }) => `/(?<${name}>${pattern})`).join("") + "$");
+const parsePath = (pathname) => {
+  const matchResults = pathname.match(OUTER_HREF_REGEXP)?.groups ?? {};
+  return PATH_SEGMENTS.reduce((acc, { name, transform }) => {
+    let value = void 0;
+    if (name in matchResults) {
+      value = matchResults[name];
+    }
+    if (!value) {
+      value = "";
+    }
+    if (typeof value === "string") {
+      acc[name] = transform ? transform(value) : value;
+    }
+    return acc;
+  }, {});
+};
+const parseHref = (href) => {
+  const parsedUrl = new URL(href);
+  const pathnameState = parsePath(parsedUrl.pathname);
+  return {
+    ...pathnameState,
+    search: parsedUrl.search.substring(1),
+    hash: parsedUrl.hash.substring(1)
+  };
+};
+const stripSlashPrefix = (s) => s.startsWith("/") ? s.substring(1) : s;
+const constructUrl = (outerHref, navigationState) => {
+  const path = PATH_SEGMENTS.map(({ name }) => {
+    let value = navigationState[name];
+    return stripSlashPrefix(value ?? "");
+  }).join("/");
+  const host = getOuterHostname(outerHref);
+  let url = `${host}/${path}`;
+  if (navigationState.search) {
+    url += "?" + navigationState.search;
+  }
+  if (navigationState.hash) {
+    url += "#" + navigationState.hash;
+  }
+  return url;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FILES_PREFIX,
+  constructOuterUrl,
+  constructUrl,
+  getOuterHostname,
+  getSearchParams,
+  isAbsolutePath,
+  isInternalHref,
+  maybeParseUrl,
+  parseHref,
+  parsePath,
+  parseTarget,
+  repositoryPrefixURL
+});
+//# sourceMappingURL=urlUtils.cjs.map

package/dist/urlUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/urlUtils.ts"],"sourcesContent":["import { joinPaths } from \"./pathUtils\";\nimport { NavigationState, PathState } from \"./TinkerableContext\";\n\nexport const FILES_PREFIX = '/files';\n\nexport const getOuterHostname = (outerHref:string) => {\n  const url = new URL(outerHref);\n  return `${url.protocol}//${url.hostname}`;\n}\n\nexport const getSearchParams = (search?: string): Record<string, string> => Object.fromEntries(\n  [...(new URLSearchParams(search ?? window.location.search).entries())]);\n\n\nexport const parseTarget = (target: string, navigation: NavigationState): NavigationState => {\n  const newNavigation = { ...navigation };\n  let [prehash, hash] = target.split(\"#\")\n  if (prehash) {\n    let [path, search] = prehash.split(\"?\")\n    if (path) {\n      newNavigation.sandboxPath = path\n    }\n    newNavigation.search = search ? search : '';\n  }\n  newNavigation.hash = hash ? hash : '';\n  return newNavigation\n}\n\n\nexport const maybeParseUrl = (str: string): URL | null => {\n  try {\n    return new URL(str);\n  } catch (_) {\n    return null;\n  }\n}\n\nexport const isAbsolutePath = (sandboxPath: string) => sandboxPath.startsWith('/');\n\nexport const repositoryPrefixURL = (outerHref:string, navigationState: NavigationState) => constructUrl(outerHref, {\n      ...navigationState,\n      sandboxPath: ''\n    });\n\nexport const constructOuterUrl = (previousOuterHref:string, sandboxTarget:string, navigationState: NavigationState, addFilesPrefix=true):string => {\n  if (isAbsolutePath(sandboxTarget)) {\n    return constructUrl(\n      previousOuterHref,\n      {\n        ...navigationState,\n        sandboxPath: addFilesPrefix ? joinPaths(FILES_PREFIX, sandboxTarget) : sandboxTarget\n      })\n  }\n  return (\n    new URL(\n      sandboxTarget,\n      constructUrl(\n        previousOuterHref,\n        navigationState\n      )\n    )\n  ).toString();\n}\n\nexport const isInternalHref = (outerHref:string, target: string, navigationState: NavigationState) => {\n  const parsedUrl = maybeParseUrl(target);\n  if (parsedUrl) {\n    return target.startsWith(repositoryPrefixURL(outerHref, navigationState));\n  }\n  // if target is not a valid URL, then assume it's relative.\n  return true;\n}\n\nexport type PathSegment = {\n  name: string,\n  pattern: string,\n  transform?: (pathSegment: string) => string\n}\n\nconst PATH_SEGMENTS: PathSegment[] = [\n  { name: 'mode', pattern: '\\\\w+' },\n  { name: 'provider', pattern: '[a-zA-Z0-9-_]+' },\n  { name: 'namespace', pattern: '[a-zA-Z0-9-_]+' },\n  { name: 'repository', pattern: '[a-zA-Z0-9-_]+' },\n  { name: 'ref', pattern: '[a-zA-Z0-9-_]+' },\n  { name: 'sandboxPath', pattern: '.*', transform: s => `/${s}` }\n];\n\nconst OUTER_HREF_REGEXP = new RegExp('^' + PATH_SEGMENTS.map(({ name, pattern }) => `\\/(?<${name}>${pattern})`).join('') + \"$\");\n\n\nexport const parsePath = (pathname: string): PathState => {\n  const matchResults = pathname.match(OUTER_HREF_REGEXP)?.groups ?? {};\n  return PATH_SEGMENTS.reduce((acc: Partial<PathState>, { name, transform }: PathSegment) => {\n    let value: string | undefined = undefined;\n    if (name in matchResults) {\n      value = matchResults[name];\n    }\n    if (!value) {\n      // fall back to default value if var not present in\n      value = '';\n    }\n    if (typeof value === 'string') {\n      acc[name] = transform ? transform(value) : value;\n    }\n    return acc;\n  }, {}) as PathState;\n}\n\nexport const parseHref = (href: string): NavigationState => {\n  const parsedUrl = new URL(href);\n  const pathnameState = parsePath(parsedUrl.pathname);\n  return {\n    ...pathnameState,\n    search: parsedUrl.search.substring(1),\n    hash: parsedUrl.hash.substring(1),\n  } as NavigationState\n}\n\nconst stripSlashPrefix = (s: string): string => s.startsWith('/') ? s.substring(1) : s;\n\nexport const constructUrl = (outerHref:string, navigationState: NavigationState): string => {\n  const path = PATH_SEGMENTS.map(({ name }) => {\n    let value = navigationState[name];\n    return stripSlashPrefix(value ?? '');\n  }).join('/');\n  const host = getOuterHostname(outerHref);\n  let url = `${host}/${path}`\n  if (navigationState.search) {\n    url += '?' + navigationState.search\n  }\n  if (navigationState.hash) {\n    url += '#' + navigationState.hash\n  }\n  return url;\n}\n"],"mappings":"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","names":[]}

package/dist/urlUtils.d.cts

@@ -0,0 +1,24 @@
+import { NavigationState, PathState } from './TinkerableContext.cjs';
+import 'react';
+import './RoutingSpec.cjs';
+import './sandboxTypes.cjs';
+
+declare const FILES_PREFIX = "/files";
+declare const getOuterHostname: (outerHref: string) => string;
+declare const getSearchParams: (search?: string) => Record<string, string>;
+declare const parseTarget: (target: string, navigation: NavigationState) => NavigationState;
+declare const maybeParseUrl: (str: string) => URL | null;
+declare const isAbsolutePath: (sandboxPath: string) => boolean;
+declare const repositoryPrefixURL: (outerHref: string, navigationState: NavigationState) => string;
+declare const constructOuterUrl: (previousOuterHref: string, sandboxTarget: string, navigationState: NavigationState, addFilesPrefix?: boolean) => string;
+declare const isInternalHref: (outerHref: string, target: string, navigationState: NavigationState) => boolean;
+type PathSegment = {
+    name: string;
+    pattern: string;
+    transform?: (pathSegment: string) => string;
+};
+declare const parsePath: (pathname: string) => PathState;
+declare const parseHref: (href: string) => NavigationState;
+declare const constructUrl: (outerHref: string, navigationState: NavigationState) => string;
+
+export { FILES_PREFIX, type PathSegment, constructOuterUrl, constructUrl, getOuterHostname, getSearchParams, isAbsolutePath, isInternalHref, maybeParseUrl, parseHref, parsePath, parseTarget, repositoryPrefixURL };

package/dist/urlUtils.d.ts

@@ -0,0 +1,24 @@
+import { NavigationState, PathState } from './TinkerableContext.js';
+import 'react';
+import './RoutingSpec.js';
+import './sandboxTypes.js';
+
+declare const FILES_PREFIX = "/files";
+declare const getOuterHostname: (outerHref: string) => string;
+declare const getSearchParams: (search?: string) => Record<string, string>;
+declare const parseTarget: (target: string, navigation: NavigationState) => NavigationState;
+declare const maybeParseUrl: (str: string) => URL | null;
+declare const isAbsolutePath: (sandboxPath: string) => boolean;
+declare const repositoryPrefixURL: (outerHref: string, navigationState: NavigationState) => string;
+declare const constructOuterUrl: (previousOuterHref: string, sandboxTarget: string, navigationState: NavigationState, addFilesPrefix?: boolean) => string;
+declare const isInternalHref: (outerHref: string, target: string, navigationState: NavigationState) => boolean;
+type PathSegment = {
+    name: string;
+    pattern: string;
+    transform?: (pathSegment: string) => string;
+};
+declare const parsePath: (pathname: string) => PathState;
+declare const parseHref: (href: string) => NavigationState;
+declare const constructUrl: (outerHref: string, navigationState: NavigationState) => string;
+
+export { FILES_PREFIX, type PathSegment, constructOuterUrl, constructUrl, getOuterHostname, getSearchParams, isAbsolutePath, isInternalHref, maybeParseUrl, parseHref, parsePath, parseTarget, repositoryPrefixURL };

package/dist/urlUtils.js

@@ -0,0 +1,124 @@
+import { joinPaths } from "./pathUtils";
+const FILES_PREFIX = "/files";
+const getOuterHostname = (outerHref) => {
+  const url = new URL(outerHref);
+  return `${url.protocol}//${url.hostname}`;
+};
+const getSearchParams = (search) => Object.fromEntries(
+  [...new URLSearchParams(search ?? window.location.search).entries()]
+);
+const parseTarget = (target, navigation) => {
+  const newNavigation = { ...navigation };
+  let [prehash, hash] = target.split("#");
+  if (prehash) {
+    let [path, search] = prehash.split("?");
+    if (path) {
+      newNavigation.sandboxPath = path;
+    }
+    newNavigation.search = search ? search : "";
+  }
+  newNavigation.hash = hash ? hash : "";
+  return newNavigation;
+};
+const maybeParseUrl = (str) => {
+  try {
+    return new URL(str);
+  } catch (_) {
+    return null;
+  }
+};
+const isAbsolutePath = (sandboxPath) => sandboxPath.startsWith("/");
+const repositoryPrefixURL = (outerHref, navigationState) => constructUrl(outerHref, {
+  ...navigationState,
+  sandboxPath: ""
+});
+const constructOuterUrl = (previousOuterHref, sandboxTarget, navigationState, addFilesPrefix = true) => {
+  if (isAbsolutePath(sandboxTarget)) {
+    return constructUrl(
+      previousOuterHref,
+      {
+        ...navigationState,
+        sandboxPath: addFilesPrefix ? joinPaths(FILES_PREFIX, sandboxTarget) : sandboxTarget
+      }
+    );
+  }
+  return new URL(
+    sandboxTarget,
+    constructUrl(
+      previousOuterHref,
+      navigationState
+    )
+  ).toString();
+};
+const isInternalHref = (outerHref, target, navigationState) => {
+  const parsedUrl = maybeParseUrl(target);
+  if (parsedUrl) {
+    return target.startsWith(repositoryPrefixURL(outerHref, navigationState));
+  }
+  return true;
+};
+const PATH_SEGMENTS = [
+  { name: "mode", pattern: "\\w+" },
+  { name: "provider", pattern: "[a-zA-Z0-9-_]+" },
+  { name: "namespace", pattern: "[a-zA-Z0-9-_]+" },
+  { name: "repository", pattern: "[a-zA-Z0-9-_]+" },
+  { name: "ref", pattern: "[a-zA-Z0-9-_]+" },
+  { name: "sandboxPath", pattern: ".*", transform: (s) => `/${s}` }
+];
+const OUTER_HREF_REGEXP = new RegExp("^" + PATH_SEGMENTS.map(({ name, pattern }) => `/(?<${name}>${pattern})`).join("") + "$");
+const parsePath = (pathname) => {
+  const matchResults = pathname.match(OUTER_HREF_REGEXP)?.groups ?? {};
+  return PATH_SEGMENTS.reduce((acc, { name, transform }) => {
+    let value = void 0;
+    if (name in matchResults) {
+      value = matchResults[name];
+    }
+    if (!value) {
+      value = "";
+    }
+    if (typeof value === "string") {
+      acc[name] = transform ? transform(value) : value;
+    }
+    return acc;
+  }, {});
+};
+const parseHref = (href) => {
+  const parsedUrl = new URL(href);
+  const pathnameState = parsePath(parsedUrl.pathname);
+  return {
+    ...pathnameState,
+    search: parsedUrl.search.substring(1),
+    hash: parsedUrl.hash.substring(1)
+  };
+};
+const stripSlashPrefix = (s) => s.startsWith("/") ? s.substring(1) : s;
+const constructUrl = (outerHref, navigationState) => {
+  const path = PATH_SEGMENTS.map(({ name }) => {
+    let value = navigationState[name];
+    return stripSlashPrefix(value ?? "");
+  }).join("/");
+  const host = getOuterHostname(outerHref);
+  let url = `${host}/${path}`;
+  if (navigationState.search) {
+    url += "?" + navigationState.search;
+  }
+  if (navigationState.hash) {
+    url += "#" + navigationState.hash;
+  }
+  return url;
+};
+export {
+  FILES_PREFIX,
+  constructOuterUrl,
+  constructUrl,
+  getOuterHostname,
+  getSearchParams,
+  isAbsolutePath,
+  isInternalHref,
+  maybeParseUrl,
+  parseHref,
+  parsePath,
+  parseTarget,
+  repositoryPrefixURL
+};
+//# sourceMappingURL=urlUtils.js.map

package/dist/urlUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/urlUtils.ts"],"sourcesContent":["import { joinPaths } from \"./pathUtils\";\nimport { NavigationState, PathState } from \"./TinkerableContext\";\n\nexport const FILES_PREFIX = '/files';\n\nexport const getOuterHostname = (outerHref:string) => {\n  const url = new URL(outerHref);\n  return `${url.protocol}//${url.hostname}`;\n}\n\nexport const getSearchParams = (search?: string): Record<string, string> => Object.fromEntries(\n  [...(new URLSearchParams(search ?? window.location.search).entries())]);\n\n\nexport const parseTarget = (target: string, navigation: NavigationState): NavigationState => {\n  const newNavigation = { ...navigation };\n  let [prehash, hash] = target.split(\"#\")\n  if (prehash) {\n    let [path, search] = prehash.split(\"?\")\n    if (path) {\n      newNavigation.sandboxPath = path\n    }\n    newNavigation.search = search ? search : '';\n  }\n  newNavigation.hash = hash ? hash : '';\n  return newNavigation\n}\n\n\nexport const maybeParseUrl = (str: string): URL | null => {\n  try {\n    return new URL(str);\n  } catch (_) {\n    return null;\n  }\n}\n\nexport const isAbsolutePath = (sandboxPath: string) => sandboxPath.startsWith('/');\n\nexport const repositoryPrefixURL = (outerHref:string, navigationState: NavigationState) => constructUrl(outerHref, {\n      ...navigationState,\n      sandboxPath: ''\n    });\n\nexport const constructOuterUrl = (previousOuterHref:string, sandboxTarget:string, navigationState: NavigationState, addFilesPrefix=true):string => {\n  if (isAbsolutePath(sandboxTarget)) {\n    return constructUrl(\n      previousOuterHref,\n      {\n        ...navigationState,\n        sandboxPath: addFilesPrefix ? joinPaths(FILES_PREFIX, sandboxTarget) : sandboxTarget\n      })\n  }\n  return (\n    new URL(\n      sandboxTarget,\n      constructUrl(\n        previousOuterHref,\n        navigationState\n      )\n    )\n  ).toString();\n}\n\nexport const isInternalHref = (outerHref:string, target: string, navigationState: NavigationState) => {\n  const parsedUrl = maybeParseUrl(target);\n  if (parsedUrl) {\n    return target.startsWith(repositoryPrefixURL(outerHref, navigationState));\n  }\n  // if target is not a valid URL, then assume it's relative.\n  return true;\n}\n\nexport type PathSegment = {\n  name: string,\n  pattern: string,\n  transform?: (pathSegment: string) => string\n}\n\nconst PATH_SEGMENTS: PathSegment[] = [\n  { name: 'mode', pattern: '\\\\w+' },\n  { name: 'provider', pattern: '[a-zA-Z0-9-_]+' },\n  { name: 'namespace', pattern: '[a-zA-Z0-9-_]+' },\n  { name: 'repository', pattern: '[a-zA-Z0-9-_]+' },\n  { name: 'ref', pattern: '[a-zA-Z0-9-_]+' },\n  { name: 'sandboxPath', pattern: '.*', transform: s => `/${s}` }\n];\n\nconst OUTER_HREF_REGEXP = new RegExp('^' + PATH_SEGMENTS.map(({ name, pattern }) => `\\/(?<${name}>${pattern})`).join('') + \"$\");\n\n\nexport const parsePath = (pathname: string): PathState => {\n  const matchResults = pathname.match(OUTER_HREF_REGEXP)?.groups ?? {};\n  return PATH_SEGMENTS.reduce((acc: Partial<PathState>, { name, transform }: PathSegment) => {\n    let value: string | undefined = undefined;\n    if (name in matchResults) {\n      value = matchResults[name];\n    }\n    if (!value) {\n      // fall back to default value if var not present in\n      value = '';\n    }\n    if (typeof value === 'string') {\n      acc[name] = transform ? transform(value) : value;\n    }\n    return acc;\n  }, {}) as PathState;\n}\n\nexport const parseHref = (href: string): NavigationState => {\n  const parsedUrl = new URL(href);\n  const pathnameState = parsePath(parsedUrl.pathname);\n  return {\n    ...pathnameState,\n    search: parsedUrl.search.substring(1),\n    hash: parsedUrl.hash.substring(1),\n  } as NavigationState\n}\n\nconst stripSlashPrefix = (s: string): string => s.startsWith('/') ? s.substring(1) : s;\n\nexport const constructUrl = (outerHref:string, navigationState: NavigationState): string => {\n  const path = PATH_SEGMENTS.map(({ name }) => {\n    let value = navigationState[name];\n    return stripSlashPrefix(value ?? '');\n  }).join('/');\n  const host = getOuterHostname(outerHref);\n  let url = `${host}/${path}`\n  if (navigationState.search) {\n    url += '?' + navigationState.search\n  }\n  if (navigationState.hash) {\n    url += '#' + navigationState.hash\n  }\n  return url;\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAGnB,MAAM,eAAe;AAErB,MAAM,mBAAmB,CAAC,cAAqB;AACpD,QAAM,MAAM,IAAI,IAAI,SAAS;AAC7B,SAAO,GAAG,IAAI,QAAQ,KAAK,IAAI,QAAQ;AACzC;AAEO,MAAM,kBAAkB,CAAC,WAA4C,OAAO;AAAA,EACjF,CAAC,GAAI,IAAI,gBAAgB,UAAU,OAAO,SAAS,MAAM,EAAE,QAAQ,CAAE;AAAC;AAGjE,MAAM,cAAc,CAAC,QAAgB,eAAiD;AAC3F,QAAM,gBAAgB,EAAE,GAAG,WAAW;AACtC,MAAI,CAAC,SAAS,IAAI,IAAI,OAAO,MAAM,GAAG;AACtC,MAAI,SAAS;AACX,QAAI,CAAC,MAAM,MAAM,IAAI,QAAQ,MAAM,GAAG;AACtC,QAAI,MAAM;AACR,oBAAc,cAAc;AAAA,IAC9B;AACA,kBAAc,SAAS,SAAS,SAAS;AAAA,EAC3C;AACA,gBAAc,OAAO,OAAO,OAAO;AACnC,SAAO;AACT;AAGO,MAAM,gBAAgB,CAAC,QAA4B;AACxD,MAAI;AACF,WAAO,IAAI,IAAI,GAAG;AAAA,EACpB,SAAS,GAAG;AACV,WAAO;AAAA,EACT;AACF;AAEO,MAAM,iBAAiB,CAAC,gBAAwB,YAAY,WAAW,GAAG;AAE1E,MAAM,sBAAsB,CAAC,WAAkB,oBAAqC,aAAa,WAAW;AAAA,EAC7G,GAAG;AAAA,EACH,aAAa;AACf,CAAC;AAEE,MAAM,oBAAoB,CAAC,mBAA0B,eAAsB,iBAAkC,iBAAe,SAAgB;AACjJ,MAAI,eAAe,aAAa,GAAG;AACjC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,GAAG;AAAA,QACH,aAAa,iBAAiB,UAAU,cAAc,aAAa,IAAI;AAAA,MACzE;AAAA,IAAC;AAAA,EACL;AACA,SACE,IAAI;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,IACF;AAAA,EACF,EACA,SAAS;AACb;AAEO,MAAM,iBAAiB,CAAC,WAAkB,QAAgB,oBAAqC;AACpG,QAAM,YAAY,cAAc,MAAM;AACtC,MAAI,WAAW;AACb,WAAO,OAAO,WAAW,oBAAoB,WAAW,eAAe,CAAC;AAAA,EAC1E;AAEA,SAAO;AACT;AAQA,MAAM,gBAA+B;AAAA,EACnC,EAAE,MAAM,QAAQ,SAAS,OAAO;AAAA,EAChC,EAAE,MAAM,YAAY,SAAS,iBAAiB;AAAA,EAC9C,EAAE,MAAM,aAAa,SAAS,iBAAiB;AAAA,EAC/C,EAAE,MAAM,cAAc,SAAS,iBAAiB;AAAA,EAChD,EAAE,MAAM,OAAO,SAAS,iBAAiB;AAAA,EACzC,EAAE,MAAM,eAAe,SAAS,MAAM,WAAW,OAAK,IAAI,CAAC,GAAG;AAChE;AAEA,MAAM,oBAAoB,IAAI,OAAO,MAAM,cAAc,IAAI,CAAC,EAAE,MAAM,QAAQ,MAAM,OAAQ,IAAI,IAAI,OAAO,GAAG,EAAE,KAAK,EAAE,IAAI,GAAG;AAGvH,MAAM,YAAY,CAAC,aAAgC;AACxD,QAAM,eAAe,SAAS,MAAM,iBAAiB,GAAG,UAAU,CAAC;AACnE,SAAO,cAAc,OAAO,CAAC,KAAyB,EAAE,MAAM,UAAU,MAAmB;AACzF,QAAI,QAA4B;AAChC,QAAI,QAAQ,cAAc;AACxB,cAAQ,aAAa,IAAI;AAAA,IAC3B;AACA,QAAI,CAAC,OAAO;AAEV,cAAQ;AAAA,IACV;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,UAAI,IAAI,IAAI,YAAY,UAAU,KAAK,IAAI;AAAA,IAC7C;AACA,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AACP;AAEO,MAAM,YAAY,CAAC,SAAkC;AAC1D,QAAM,YAAY,IAAI,IAAI,IAAI;AAC9B,QAAM,gBAAgB,UAAU,UAAU,QAAQ;AAClD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ,UAAU,OAAO,UAAU,CAAC;AAAA,IACpC,MAAM,UAAU,KAAK,UAAU,CAAC;AAAA,EAClC;AACF;AAEA,MAAM,mBAAmB,CAAC,MAAsB,EAAE,WAAW,GAAG,IAAI,EAAE,UAAU,CAAC,IAAI;AAE9E,MAAM,eAAe,CAAC,WAAkB,oBAA6C;AAC1F,QAAM,OAAO,cAAc,IAAI,CAAC,EAAE,KAAK,MAAM;AAC3C,QAAI,QAAQ,gBAAgB,IAAI;AAChC,WAAO,iBAAiB,SAAS,EAAE;AAAA,EACrC,CAAC,EAAE,KAAK,GAAG;AACX,QAAM,OAAO,iBAAiB,SAAS;AACvC,MAAI,MAAM,GAAG,IAAI,IAAI,IAAI;AACzB,MAAI,gBAAgB,QAAQ;AAC1B,WAAO,MAAM,gBAAgB;AAAA,EAC/B;AACA,MAAI,gBAAgB,MAAM;AACxB,WAAO,MAAM,gBAAgB;AAAA,EAC/B;AACA,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@immediately-run/sdk",
+  "version": "0.1.0",
+  "description": "Runtime SDK for code executing inside an immediately.run sandbox.",
+  "license": "MIT",
+  "repository": "github:immediately-run/immediately-run-sdk",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "require": "./dist/*.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "jest",
+    "docs": "typedoc",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "dependencies": {
+    "react-error-boundary": "^6.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "jest": "^29.5.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.0.0",
+    "typedoc": "^0.27.0",
+    "typescript": "^5.6.0"
+  }
+}