andesine 0.0.1-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Vrite, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,163 @@
+# Vrite JavaScript SDK
+
+[Vrite JavaScript SDK](https://github.com/vriteio/vrite/tree/main/packages/sdk) is a one-stop-shop when building any kind of Vrite-powered website or web app.
+
+Currently it includes the following parts:
+
+- **API client** — for easy access to Vrite API;
+- **Content transformers** — functions used to transform Vrite JSON content into different formats;
+- **Astro integration** — dedicated integration for [Astro](<%5Bhttps://astro.build/%5D(https://astro.build/)>);
+- **Extensions SDK** - for building custom extensions for Vrite;
+
+## Installation
+
+```shell
+npm i @vrite/sdk
+```
+
+## Usage
+
+The Vrite SDK is modular, so you can import only the parts of it you need. On top of that, it's **isomorphic**, with both the API client and content transformers library being able to run both in the browser and Node.js.
+
+### API client
+
+Start by initializing the API client, by importing the library, and providing your API access token:
+
+```javascript
+import { createClient } from "@vrite/sdk/api";
+const vrite = createClient({
+  token: "[YOUR_API_TOKEN]"
+});
+```
+
+With the client configured, you can access [all the endpoints of the Vrite API](https://generator.swagger.io/?url=https://api.vrite.io/swagger.json) via convenient JavaScript methods. Here are a few examples:
+
+```javascript
+// Get all content groups
+const contentGroups = await vrite.contentGroups.list();
+// Get all content pieces from a content group
+const contentPieces = await vrite.contentPieces.list({
+  contentGroupId: "[CONTENT_GROUP_ID]"
+});
+// Get the entire conten piece with JSON content
+const contentPiece = await vrite.contentPieces.get({
+  id: "[CONTENT_PIECE_ID]",
+  content: true
+});
+```
+
+To explore available endpoints, check out [Vrite API docs](https://generator.swagger.io/?url=https://api.vrite.io/swagger.json). On top of that, the API client is **fully typed** (written in TypeScript) so you can easily find your way using your modern code editor's autocomplete functionality.
+
+### Content transformers
+
+**Content transformers** are functions dedicated to processing Vrite JSON output and adapting it to required string-based formats.
+
+The JSON output, based on the [ProseMirror](https://prosemirror.net/) library powering the Vrite Editor, is very versatile and easy to process, making it the ideal choice, no matter how your content has to be delivered. Content transformers help with this process by further simplifying the processing of these recursive JSON trees to output strings.
+
+```javascript
+import { createContentTransformer, gfmTransformer, htmlTransformer } from "@vrite/sdk/transformers";
+
+const sampleVriteJSON = {
+  // ...
+};
+// Transforms JSON to GitHub Flavored Markdown format
+const gfmOutput = gfmTransformer(sampleVriteJSON);
+// Transforms JSON to HTML format
+const htmlOutput = htmlTransformer(sampleVriteJSON);
+// Create your own content transformers
+const customContentTransformer = createContentTransformer({
+  applyInlineFormatting(type, attrs, content) {
+    switch (type) {
+      case "link":
+        return `<a href="${attrs.href}">${content}</a>`;
+      case "bold":
+        return `<strong>${content}</strong>`;
+      case "code":
+        return `<code>${content}</code>`;
+      case "italic":
+        return `<em>${content}</em>`;
+      default:
+        return content;
+    }
+  },
+  transformNode(type, attrs, content) {
+    switch (type) {
+      case "paragraph":
+        return `<p>${content}</p>`;
+      case "heading":
+        return `<h${attrs?.level || 1}>${content}</h${attrs?.level || 1}>`;
+      case "blockquote":
+        return `<blockquote>${content}</blockquote>`;
+      case "bulletList":
+        return `<ul>${content}</ul>`;
+      case "orderedList":
+        return `<ol>${content}</ol>`;
+      case "listItem":
+        return `<li>${content}</li>`;
+      case "horizontalRule":
+        return `<hr/>`;
+      default:
+        return content;
+    }
+  }
+});
+```
+
+The SDK provides built-in content transformers for both HTML and GFM formats.
+
+### Astro integration
+
+Vrite Astro integration makes integrating Vrite with your Astro-powered website really easy!
+
+Start by adding the Vrite plugin into the Astro config:
+
+```javascript
+import { defineConfig } from "astro/config";
+import { vritePlugin } from "@vrite/sdk/astro";
+export default defineConfig({
+  integrations: [
+    // ...
+    vritePlugin({
+      accessToken: "[YOUR_ACCESS_TOKEN]",
+      contentGroupId: "[CONTENT_GROUP_ID]"
+    })
+    // ...
+  ]
+});
+```
+
+In the configuration provide both your **API access token**, as well as the **ID of the content group** containing the posts for publishing on your Astro-powered website.
+
+If you're using **TypeScript**, add the following to your _tsconfig.json_, under `compilerOptions.types`:
+
+```json
+{ "compilerOptions": { "types": ["@vrite/sdk/types"] } }
+```
+
+Now you can import from a `virtual:vrite` module that provides configured API client, along with a few utils for integrating Vrite with Astro:
+
+```astro
+---
+import { Content, client, getContentPieces, getStaticPaths } from "virtual:vrite";
+
+// Pre-configured Vrite API client
+const settings = await client.userSettings.get();
+// Utility to retrieve content pieces from the configured content group
+const contentPieces = await getContentPieces();
+// Shortcut for retriving all content pieces for use with Astro SSG
+export getStaticPaths;
+---
+
+<!-- Renders the Vrite content piece, specified by ID or slug -->
+<content contentPieceId="..." slug="..." />
+```
+
+- `Content` — renders Vrite content piece specified either by ID (`contentPieceId` prop) or a slug (`slug` prop); Useful when in SSR mode;
+- `client` — pre-configured Vrite API client for easy access;
+  - `getContentPieces` — retrieves content pieces from the content group specified in the config file. Accepts an object with the following properties:
+  - `limit?: number | "all" = 50` — how many content pieces to retrieve; `"all"` retrieves all of them, in batches of 50;
+  - `startPage?: number = 1` — if `limit` is a number and pagination is used, what page to start retrieving content pieces from?
+  - `tagId?: string` — Tag ID, if you want to filter results by specific tag.
+- `getStaticPaths` — shortcut function for easy re-export when using Vrite SSG and inside _[slug].astro_ file. It returns `params.slug` as the content piece's slug and all basic content piece properties as `props`.
+
+For a more detailed guide on using the Vrite Astro integration, [check out this blog post](https://vrite.io/blog/start-programming-blog-in-minutes-with-astro-and-vrite/).

package/dist/api.cjs

@@ -0,0 +1 @@
+"use strict";const w=require("@sanity/eventsource");function _interopDefaultCompat(c){return c&&typeof c=="object"&&"default"in c?c.default:c}const w__default=_interopDefaultCompat(w),n$4="/content-groups",r$3=c=>({get:p=>c("GET",`${n$4}`,{params:p}),list:p=>c("GET",`${n$4}/list`,{params:p}),create:p=>c("POST",`${n$4}`,{body:p}),update:p=>c("PUT",`${n$4}`,{body:p}),delete:p=>c("DELETE",`${n$4}`,{params:p})}),e$2="/content-pieces",a$3=c=>({get:p=>c("GET",`${e$2}`,{params:p}),create:p=>c("POST",`${e$2}`,{body:p}),update:p=>c("PUT",`${e$2}`,{body:p}),delete:p=>c("DELETE",`${e$2}`,{params:p}),list:({contentGroupId:p,...u})=>c("GET",`${e$2}/list`,{params:{...u,...p&&{contentGroupId:typeof p=="string"?p:p.join(",")}}})}),b=c=>{let p=c.baseURL||"https://api.vrite.io",u=c.extensionId||"",T=c.headers||{},G=null,{token:h}=c;return{sendRequest:async(d,$,m)=>{try{const{default:E}=await import("isomorphic-unfetch"),g=await E(`${p}${$}/?${encodeURI(Object.entries(m?.params||{}).filter(([,P])=>P).map(([P,k])=>`${P}=${k}`).join("&"))}`,{headers:{Authorization:`Bearer ${h}`,Accept:"application/json",...m?.body?{"Content-Type":"application/json"}:{},...u?{"X-Vrite-Extension-ID":u}:{},...T},body:m?.body?JSON.stringify(m.body):null,signal:G,method:d});G=null;let l=null;try{if(l=await g.json(),!l)return}catch{return}if(!g.ok)throw l;const f=g.headers.get("x-pagination-total");return f?Object.assign(l,{meta:{pagination:{total:parseInt(f),pages:parseInt(g.headers.get("x-pagination-pages")||"0"),perPage:parseInt(g.headers.get("x-pagination-per-page")||"0"),page:parseInt(g.headers.get("x-pagination-page")||"0")}}}):l}catch(E){throw console.error(E),E}},reconfigure:d=>{p=d.baseURL||p,h=d.token||h,u=d.extensionId||u,T=d.headers||T},useSignal:d=>{G=d},getConfig:()=>({baseURL:p,token:h,extensionId:u,headers:T}),getSignal:()=>G}},t$5="/user-settings",r$2=c=>({get:()=>c("GET",`${t$5}`),update:p=>c("PUT",`${t$5}`,{body:p})}),t$4="/tags",e$1=c=>({get:p=>c("GET",`${t$4}`,{params:p}),update:p=>c("PUT",`${t$4}`,{body:p}),create:p=>c("PUT",`${t$4}`,{body:p}),delete:p=>c("DELETE",`${t$4}`,{params:p}),list:p=>c("GET",`${t$4}/list`,{params:p})}),i$1="/profile",n$3=c=>({get:()=>c("GET",`${i$1}`)}),t$3="/webhooks",n$2=c=>({get:p=>c("GET",`${t$3}`,{params:p}),create:p=>c("POST",`${t$3}`,{body:p}),update:p=>c("PUT",`${t$3}`,{body:p}),delete:p=>c("DELETE",`${t$3}`,{params:p}),list:p=>c("GET",`${t$3}/list`,{params:p})}),s="/workspace",t$2=c=>({get:()=>c("GET",`${s}`)}),o$1="/roles",a$2=c=>({get:p=>c("GET",`${o$1}`,{params:p}),create:p=>c("POST",`${o$1}`,{body:p}),update:p=>c("PUT",`${o$1}`,{body:p}),delete:p=>c("DELETE",`${o$1}`,{params:p}),list:p=>c("GET",`${o$1}/list`,{params:p})}),t$1="/workspace-settings",a$1=c=>({get:()=>c("GET",`${t$1}`),update:p=>c("PUT",`${t$1}`,{body:p})}),r$1=c=>({listMembers:p=>c("GET","/workspace-memberships/list-members",{params:p}),listWorkspaces:p=>c("GET","/workspace-memberships/list-workspaces",{params:p}),create:p=>c("POST","/workspace-memberships",{body:p}),update:p=>c("PUT","/workspace-memberships",{body:p}),delete:p=>c("DELETE","/workspace-memberships",{params:p})}),e="/extension",o=c=>({get:()=>c("GET",`${e}`),getData:()=>c("GET",`${e}/data`),updateData:p=>c("PUT",`${e}/data`,{body:p}),updateContentPieceData:p=>c("POST",`${e}/content-piece-data`,{body:p})}),r="/variants",a=c=>({create:p=>c("POST",`${r}`,{body:p}),update:p=>c("PUT",`${r}`,{body:p}),delete:p=>c("DELETE",`${r}`,{params:p}),list:()=>c("GET",`${r}/list`)}),t="/transformers",n$1=c=>({create:p=>c("POST",`${t}`,{body:p}),delete:p=>c("DELETE",`${t}`,{params:p}),list:()=>c("GET",`${t}/list`)}),n="/snippets",i=c=>({get:p=>c("GET",`${n}`,{params:p}),create:p=>c("POST",`${n}`,{body:p}),update:p=>c("PUT",`${n}`,{body:p}),delete:p=>c("DELETE",`${n}`,{params:p}),list:p=>c("GET",`${n}/list`,{params:p})}),y=c=>{const{sendRequest:p,reconfigure:u,getConfig:T,getSignal:G,useSignal:h}=b(c),d={contentGroups:r$3(p),contentPieces:a$3(p),snippets:i(p),tags:e$1(p),profile:n$3(p),userSettings:r$2(p),webhooks:n$2(p),workspace:t$2(p),roles:a$2(p),workspaceSettings:a$1(p),workspaceMemberships:r$1(p),extension:o(p),variants:a(p),transformers:n$1(p),search($){return p("GET","/search",{params:$})},async ask($){let m="";const E=new w__default(`${T().baseURL}/search/ask?query=${encodeURIComponent($.query)}`,{headers:{Authorization:`Bearer ${T().token}`,"Content-Type":"application/json",Accept:"application/json"}});E.addEventListener("error",g=>{const l=g;return l.message?$.onError?.(l.message):(E.close(),$.onEnd?.(m))}),E.addEventListener("message",g=>{const l=decodeURIComponent(g.data);m+=l,$.onChunk?.(l,m)}),G()?.addEventListener("abort",()=>{E.close()}),h(null)},useSignal($){return h($),d},reconfigure($){return u($),d},getConfig(){return T()}};return d};exports.createClient=y;

package/dist/api.d.cts

@@ -0,0 +1,22 @@
+export { B as Block, C as Client, a as ContentGroup, b as ContentGroupWithSubtree, E as Embed, l as Extension, L as ListedMember, k as ListedWorkspace, M as Mark, R as Role, e as RoleBaseType, f as RolePermission, S as SearchResult, d as Snippet, U as UIAccentColor, g as UserSettings, V as Variant, W as Webhook, h as WebhookEvent, i as WorkspaceDetails, j as WorkspaceSettings, c as createClient } from './shared/andesine.3cb4e565.cjs';
+export { C as ContentPiece, a as ContentPieceWithAdditionalData, J as JSONContent, b as JSONContentAttrs, P as Profile, T as Tag, c as TagColor } from './shared/andesine.5e4b2db8.cjs';
+
+interface UnauthorizedError {
+    message: string;
+    code: "UNAUTHORIZED";
+}
+interface BadRequestError {
+    message: string;
+    code: "BAD_REQUEST";
+    issues: Array<{
+        code: string;
+        path: string[];
+        message: string;
+        expected?: string;
+        received?: string;
+        validation?: string;
+    }>;
+}
+type APIError = UnauthorizedError | BadRequestError;
+
+export type { APIError, BadRequestError, UnauthorizedError };

package/dist/api.d.mts

@@ -0,0 +1,22 @@
+export { B as Block, C as Client, a as ContentGroup, b as ContentGroupWithSubtree, E as Embed, l as Extension, L as ListedMember, k as ListedWorkspace, M as Mark, R as Role, e as RoleBaseType, f as RolePermission, S as SearchResult, d as Snippet, U as UIAccentColor, g as UserSettings, V as Variant, W as Webhook, h as WebhookEvent, i as WorkspaceDetails, j as WorkspaceSettings, c as createClient } from './shared/andesine.e974d2fa.mjs';
+export { C as ContentPiece, a as ContentPieceWithAdditionalData, J as JSONContent, b as JSONContentAttrs, P as Profile, T as Tag, c as TagColor } from './shared/andesine.5e4b2db8.mjs';
+
+interface UnauthorizedError {
+    message: string;
+    code: "UNAUTHORIZED";
+}
+interface BadRequestError {
+    message: string;
+    code: "BAD_REQUEST";
+    issues: Array<{
+        code: string;
+        path: string[];
+        message: string;
+        expected?: string;
+        received?: string;
+        validation?: string;
+    }>;
+}
+type APIError = UnauthorizedError | BadRequestError;
+
+export type { APIError, BadRequestError, UnauthorizedError };

package/dist/api.d.ts

@@ -0,0 +1,22 @@
+export { B as Block, C as Client, a as ContentGroup, b as ContentGroupWithSubtree, E as Embed, l as Extension, L as ListedMember, k as ListedWorkspace, M as Mark, R as Role, e as RoleBaseType, f as RolePermission, S as SearchResult, d as Snippet, U as UIAccentColor, g as UserSettings, V as Variant, W as Webhook, h as WebhookEvent, i as WorkspaceDetails, j as WorkspaceSettings, c as createClient } from './shared/andesine.bcb7a57d.js';
+export { C as ContentPiece, a as ContentPieceWithAdditionalData, J as JSONContent, b as JSONContentAttrs, P as Profile, T as Tag, c as TagColor } from './shared/andesine.5e4b2db8.js';
+
+interface UnauthorizedError {
+    message: string;
+    code: "UNAUTHORIZED";
+}
+interface BadRequestError {
+    message: string;
+    code: "BAD_REQUEST";
+    issues: Array<{
+        code: string;
+        path: string[];
+        message: string;
+        expected?: string;
+        received?: string;
+        validation?: string;
+    }>;
+}
+type APIError = UnauthorizedError | BadRequestError;
+
+export type { APIError, BadRequestError, UnauthorizedError };

package/dist/api.mjs

@@ -0,0 +1 @@
+import f from"@sanity/eventsource";const l="/content-groups",S=t=>({get:e=>t("GET",`${l}`,{params:e}),list:e=>t("GET",`${l}/list`,{params:e}),create:e=>t("POST",`${l}`,{body:e}),update:e=>t("PUT",`${l}`,{body:e}),delete:e=>t("DELETE",`${l}`,{params:e})}),g="/content-pieces",L=t=>({get:e=>t("GET",`${g}`,{params:e}),create:e=>t("POST",`${g}`,{body:e}),update:e=>t("PUT",`${g}`,{body:e}),delete:e=>t("DELETE",`${g}`,{params:e}),list:({contentGroupId:e,...o})=>t("GET",`${g}/list`,{params:{...o,...e&&{contentGroupId:typeof e=="string"?e:e.join(",")}}})}),D=t=>{let e=t.baseURL||"https://api.vrite.io",o=t.extensionId||"",i=t.headers||{},$=null,{token:d}=t;return{sendRequest:async(s,a,c)=>{try{const{default:p}=await import("isomorphic-unfetch"),n=await p(`${e}${a}/?${encodeURI(Object.entries(c?.params||{}).filter(([,h])=>h).map(([h,U])=>`${h}=${U}`).join("&"))}`,{headers:{Authorization:`Bearer ${d}`,Accept:"application/json",...c?.body?{"Content-Type":"application/json"}:{},...o?{"X-Vrite-Extension-ID":o}:{},...i},body:c?.body?JSON.stringify(c.body):null,signal:$,method:s});$=null;let r=null;try{if(r=await n.json(),!r)return}catch{return}if(!n.ok)throw r;const P=n.headers.get("x-pagination-total");return P?Object.assign(r,{meta:{pagination:{total:parseInt(P),pages:parseInt(n.headers.get("x-pagination-pages")||"0"),perPage:parseInt(n.headers.get("x-pagination-per-page")||"0"),page:parseInt(n.headers.get("x-pagination-page")||"0")}}}):r}catch(p){throw console.error(p),p}},reconfigure:s=>{e=s.baseURL||e,d=s.token||d,o=s.extensionId||o,i=s.headers||i},useSignal:s=>{$=s},getConfig:()=>({baseURL:e,token:d,extensionId:o,headers:i}),getSignal:()=>$}},k="/user-settings",I=t=>({get:()=>t("GET",`${k}`),update:e=>t("PUT",`${k}`,{body:e})}),E="/tags",O=t=>({get:e=>t("GET",`${E}`,{params:e}),update:e=>t("PUT",`${E}`,{body:e}),create:e=>t("PUT",`${E}`,{body:e}),delete:e=>t("DELETE",`${E}`,{params:e}),list:e=>t("GET",`${E}/list`,{params:e})}),x="/profile",C=t=>({get:()=>t("GET",`${x}`)}),T="/webhooks",j=t=>({get:e=>t("GET",`${T}`,{params:e}),create:e=>t("POST",`${T}`,{body:e}),update:e=>t("PUT",`${T}`,{body:e}),delete:e=>t("DELETE",`${T}`,{params:e}),list:e=>t("GET",`${T}/list`,{params:e})}),R="/workspace",v=t=>({get:()=>t("GET",`${R}`)}),m="/roles",q=t=>({get:e=>t("GET",`${m}`,{params:e}),create:e=>t("POST",`${m}`,{body:e}),update:e=>t("PUT",`${m}`,{body:e}),delete:e=>t("DELETE",`${m}`,{params:e}),list:e=>t("GET",`${m}/list`,{params:e})}),w="/workspace-settings",A=t=>({get:()=>t("GET",`${w}`),update:e=>t("PUT",`${w}`,{body:e})}),z=t=>({listMembers:e=>t("GET","/workspace-memberships/list-members",{params:e}),listWorkspaces:e=>t("GET","/workspace-memberships/list-workspaces",{params:e}),create:e=>t("POST","/workspace-memberships",{body:e}),update:e=>t("PUT","/workspace-memberships",{body:e}),delete:e=>t("DELETE","/workspace-memberships",{params:e})}),b="/extension",B=t=>({get:()=>t("GET",`${b}`),getData:()=>t("GET",`${b}/data`),updateData:e=>t("PUT",`${b}/data`,{body:e}),updateContentPieceData:e=>t("POST",`${b}/content-piece-data`,{body:e})}),y="/variants",M=t=>({create:e=>t("POST",`${y}`,{body:e}),update:e=>t("PUT",`${y}`,{body:e}),delete:e=>t("DELETE",`${y}`,{params:e}),list:()=>t("GET",`${y}/list`)}),G="/transformers",J=t=>({create:e=>t("POST",`${G}`,{body:e}),delete:e=>t("DELETE",`${G}`,{params:e}),list:()=>t("GET",`${G}/list`)}),u="/snippets",N=t=>({get:e=>t("GET",`${u}`,{params:e}),create:e=>t("POST",`${u}`,{body:e}),update:e=>t("PUT",`${u}`,{body:e}),delete:e=>t("DELETE",`${u}`,{params:e}),list:e=>t("GET",`${u}/list`,{params:e})}),V=t=>{const{sendRequest:e,reconfigure:o,getConfig:i,getSignal:$,useSignal:d}=D(t),s={contentGroups:S(e),contentPieces:L(e),snippets:N(e),tags:O(e),profile:C(e),userSettings:I(e),webhooks:j(e),workspace:v(e),roles:q(e),workspaceSettings:A(e),workspaceMemberships:z(e),extension:B(e),variants:M(e),transformers:J(e),search(a){return e("GET","/search",{params:a})},async ask(a){let c="";const p=new f(`${i().baseURL}/search/ask?query=${encodeURIComponent(a.query)}`,{headers:{Authorization:`Bearer ${i().token}`,"Content-Type":"application/json",Accept:"application/json"}});p.addEventListener("error",n=>{const r=n;return r.message?a.onError?.(r.message):(p.close(),a.onEnd?.(c))}),p.addEventListener("message",n=>{const r=decodeURIComponent(n.data);c+=r,a.onChunk?.(r,c)}),$()?.addEventListener("abort",()=>{p.close()}),d(null)},useSignal(a){return d(a),s},reconfigure(a){return o(a),s},getConfig(){return i()}};return s};export{V as createClient};

package/dist/extensions.cjs

@@ -0,0 +1 @@
+"use strict";const E=Symbol("usableEnv"),c=Symbol("value"),r=Symbol("id"),d=Symbol("componentName"),i={data:{},func:{},views:{},effects:[],currentScope:null},b=async(...e)=>{await Promise.all(i.effects.filter(t=>t.dependencies.some(n=>e.includes(n))).map(t=>t.run()))},p={},x=()=>`_${Math.random().toString(36).substring(2,9)}`,o=e=>e&&(typeof e=="object"||typeof e=="function")&&r in e&&c in e,g=new Proxy({},{get(e,t){const n=()=>{};return Object.defineProperty(n,d,{value:t}),n}});function m(e){if(!i.data.temp){const s=()=>i.data.temp[c];Object.defineProperty(s,r,{value:"temp"}),Object.defineProperty(s,c,{value:{},writable:!0}),i.data.temp=s}const t=x(),n=s=>{const a=i.data.temp;a[c][t]&&(a[c][t][c]=s),b(`temp.${t}`)},u=()=>i.data.temp[c][t][c];return Object.defineProperty(u,r,{value:`temp.${t}`}),Object.defineProperty(u,c,{value:e,writable:!0}),i.data.temp[c][t]=u,i.currentScope&&i.currentScope.temp.push(t),[u,n]}function C(e,t,n){const u=x();i.effects.push({[r]:u,dependencies:t.map(s=>s[r]),run:e}),i.currentScope&&i.currentScope.effects.push(u),n?.initial&&e()}const l=Object.assign(function(e,t){const[n,u]=m(e());return C(()=>{u(e())},t,{initial:!0}),n},{eq:(...e)=>{const t=e.filter(o);return l(()=>e.every(n=>(o(n)?n():n)===(o(e[0])?e[0]():e[0])),t)},neq:(...e)=>{const t=e.filter(o);return l(()=>e.some(n=>(o(n)?n():n)!==(o(e[0])?e[0]():e[0])),t)},gt:(e,t)=>{const n=[...o(e)?[e]:[],...o(t)?[t]:[]];return l(()=>(o(e)?e():e)>(o(t)?t():t),n)},lt:(e,t)=>{const n=[...o(e)?[e]:[],...o(t)?[t]:[]];return l(()=>(o(e)?e():e)<(o(t)?t():t),n)},and:(...e)=>{const t=e.filter(o);return l(()=>e.every(n=>o(n)?n():n),t)},or:(...e)=>{const t=e.filter(o);return l(()=>e.some(n=>o(n)?n():n),t)},not:e=>l(()=>!(o(e)?e():e),o(e)?[e]:[]),add:(...e)=>{const t=e.filter(o);return l(()=>e.reduce((n,u)=>n+(o(u)?u():u),0),t)},join:(...e)=>{const t=e.filter(o);return l(()=>e.reduce((n,u)=>n+(o(u)?u():u),""),t)},sub:(...e)=>{const t=e.filter(o);return l(()=>e.reduce((n,u)=>n-u(),0),t)},mul:(...e)=>{const t=e.filter(o);return l(()=>e.reduce((n,u)=>n*u(),1),t)},div:(e,t)=>{const n=[...o(e)?[e]:[],...o(t)?[t]:[]];return l(()=>(o(e)?e():e)/(o(t)?t():t),n)},mod:(e,t)=>{const n=[...o(e)?[e]:[],...o(t)?[t]:[]];return l(()=>(o(e)?e():e)%(o(t)?t():t),n)},neg:e=>l(()=>-(o(e)?e():e),o(e)?[e]:[]),when:(e,t,n)=>{const u=o(e)?[e]:[],s=o(t)?[t]:[],a=o(n)?[n]:[];return l(()=>(o(e)?e():e)?o(t)?t():t:n?o(n)?n():n:null,[...u,...s,...a])}}),f=e=>{const t=x(),n=e;return Object.defineProperty(n,r,{value:t}),i.func[t]=n,i.currentScope&&i.currentScope.func.push(t),n},y=(e,t,...n)=>({component:e[d]||"Fragment",slot:n,props:Object.fromEntries(Object.keys(t||{}).map(u=>{const s=t[u];return s&&s[r]?[u,s[r]]:[u,s]}))}),v=(...e)=>({component:"Fragment",slot:e,props:{}}),_=e=>{const t=x(),n={[r]:t,[c]:e};return i.views[t]=n,n},V=e=>{const t=p[e];t&&(t.func.forEach(n=>{delete i.func[n]}),t.temp.forEach(n=>{const u=i.data.temp;u()&&delete u()[n]}),t.effects.forEach(n=>{i.effects=i.effects.filter(u=>u[r]!==n)}))},w=e=>({getEnvironment:()=>i,getMetadata:()=>({__value:c,__id:r,__componentName:d,__usableEnv:E}),triggerEffects:b,generateRuntimeSpec:()=>({...e,onUninstall:e.onUninstall?.[r],onConfigure:e.onConfigure?.[r],configurationView:e.configurationView?.[r],contentPieceView:e.contentPieceView?.[r],blockActions:e.blockActions?.map(t=>({...t,view:t.view[r]})),elements:e.elements?.map(t=>({...t,view:t.view[r]})),page:e.page&&{mainView:e.page.mainView?.[r],sidePanelView:e.page.sidePanelView?.[r]}||void 0}),generateView:async(t,n,u)=>{const s=i.views[t]?.[c];if(s){i.currentScope={func:[],temp:[],effects:[],uid:u};const a=await s(n);return p[`view:${u}`]=i.currentScope,i.currentScope=null,a}return{component:"",slot:[]}},runFunction:async(t,n,u)=>{const s=i.func[t];s&&(i.currentScope={func:[],temp:[],effects:[],uid:u},await s(n),p[`func:${u}`]=i.currentScope,i.currentScope=null,V(`func:${u}`))},removeScope:V});exports.Components=g,exports.computed=l,exports.createElement=y,exports.createFragment=v,exports.createFunction=f,exports.createRuntime=w,exports.createTemp=m,exports.createView=_,exports.effect=C,exports.generateId=x,exports.isVal=o;

package/dist/extensions.d.cts

@@ -0,0 +1,351 @@
+import { C as Client } from './shared/andesine.3cb4e565.cjs';
+import { a as ContentPieceWithAdditionalData, J as JSONContent } from './shared/andesine.5e4b2db8.cjs';
+
+type ContextValue = string | number | boolean | undefined | null | ContextObject | ContextArray;
+type ContextObject = {
+    [x: string]: ContextValue;
+};
+type ContextArray = Array<ContextValue>;
+type IsFunction<T, R, Fallback = T> = T extends (...args: any[]) => any ? R : Fallback;
+type IsObject<T, R, Fallback = T> = IsFunction<T, Fallback, T extends object ? (T extends any[] ? Fallback : R) : Fallback>;
+type Tail<S> = S extends `${string}.${infer T}` ? Tail<T> : S;
+type Value<T> = T[keyof T];
+type FlattenStepOne<T> = {
+    [K in keyof T as K extends string ? IsObject<T[K], `${K}.${keyof T[K] & string}`, K> : K]: IsObject<T[K], {
+        [key in keyof T[K]]: T[K][key];
+    }>;
+};
+type FlattenStepTwo<T> = {
+    [a in keyof T]: IsObject<T[a], Value<{
+        [M in keyof T[a] as M extends Tail<a> ? M : never]: T[a][M];
+    }>>;
+};
+type FlattenOneLevel<T> = FlattenStepTwo<FlattenStepOne<T>>;
+type Flatten<T> = T extends FlattenOneLevel<T> ? T : Flatten<FlattenOneLevel<T>>;
+type UsableEnv<R extends ContextObject = ContextObject, W extends ContextObject = ContextObject> = {
+    readable: R;
+    writable: W;
+};
+type ExtensionContentType = "paragraph" | "heading" | "blockquote" | "element" | "image" | "codeBlock" | "embed" | "bulletList" | "orderedList" | "taskList" | "horizontalRule" | "table" | "block";
+type UseEnv<C extends ExtensionBaseContext> = C[typeof __usableEnv] extends UsableEnv ? <K extends keyof Flatten<C[typeof __usableEnv]["readable"]> | keyof Flatten<C[typeof __usableEnv]["writable"]> | keyof C[typeof __usableEnv]["readable"] | keyof C[typeof __usableEnv]["writable"]>(key: K) => K extends keyof Flatten<C[typeof __usableEnv]["readable"]> ? Val<Flatten<C[typeof __usableEnv]["readable"]>[K]> : K extends keyof Flatten<C[typeof __usableEnv]["writable"]> ? [
+    MutableVal<Flatten<C[typeof __usableEnv]["writable"]>[K]>,
+    (value: Flatten<C[typeof __usableEnv]["writable"]>[K]) => void
+] : K extends keyof C[typeof __usableEnv]["readable"] ? Val<C[typeof __usableEnv]["readable"][K]> : K extends keyof C[typeof __usableEnv]["writable"] ? [
+    MutableVal<C[typeof __usableEnv]["writable"][K]>,
+    (value: C[typeof __usableEnv]["writable"][K]) => void
+] : never : never;
+interface ExtensionBaseContext<C extends ContextObject = ContextObject> {
+    client: Omit<Client, "reconfigure">;
+    token: string;
+    extensionId: string;
+    config?: C;
+    spec: ExtensionSpec;
+    [__usableEnv]: UsableEnv<any, any>;
+    use: UseEnv<this>;
+    flush(): Promise<void>;
+    notify(message: {
+        text: string;
+        type: "success" | "error";
+    }): Promise<void>;
+}
+interface ExtensionBaseViewContext<C extends ContextObject = ContextObject> extends ExtensionBaseContext<C> {
+    css(strings: TemplateStringsArray, ...values: Array<ContextValue>): string;
+}
+interface ExtensionConfigurationViewContext<C extends ContextObject = ContextObject> extends ExtensionBaseViewContext<C> {
+    [__usableEnv]: UsableEnv<{
+        [__value]: any;
+    }, {
+        config: C;
+    }>;
+}
+interface ExtensionContentPieceViewContext<C extends ContextObject = ContextObject, D extends ContextObject = ContextObject> extends ExtensionBaseViewContext<C> {
+    [__usableEnv]: UsableEnv<{
+        contentPiece: ContentPieceWithAdditionalData;
+    }, {
+        data: D;
+    }>;
+}
+interface ExtensionBlockActionViewContext<C extends ContextObject = ContextObject> extends ExtensionBaseViewContext<C> {
+    [__usableEnv]: UsableEnv<{
+        content: JSONContent;
+    }, {
+        [__value]: any;
+    }>;
+    replaceContent(contentHTML: string): Promise<void>;
+    refreshContent(): Promise<void>;
+}
+interface ExtensionElementViewContext<C extends ContextObject = ContextObject, P extends Record<string, any> = Record<string, any>> extends ExtensionBaseViewContext<C> {
+    [__usableEnv]: UsableEnv<{
+        [__value]: any;
+    }, {
+        props: P;
+    }>;
+}
+declare const __brand: unique symbol;
+declare const __props: unique symbol;
+declare const __mutable: unique symbol;
+declare const __usableEnv: unique symbol;
+declare const __value: unique symbol;
+declare const __id: unique symbol;
+declare const __componentName: unique symbol;
+type Brand<B> = {
+    [__brand]: B;
+};
+type Val<V extends ContextValue | {
+    [K: string]: Val;
+} = ContextValue | {
+    [K: string]: Val;
+}> = Brand<"Val"> & {
+    (): V;
+    [__value]: V;
+    [__id]: string;
+};
+type MutableVal<V extends ContextValue | {
+    [K: string]: MutableVal;
+} = ContextValue | {
+    [K: string]: MutableVal;
+}> = Val<V> & {
+    [__mutable]: true;
+};
+type Func<C extends ExtensionBaseContext | never = never> = Brand<"Func"> & {
+    (context: C): void | Promise<void>;
+    [__id]: string;
+};
+interface ExtensionEnvironment {
+    data: Record<string, Val>;
+    func: Record<string, Func<any>>;
+    views: Record<string, View<any>>;
+    effects: Array<{
+        [__id]: string;
+        dependencies: string[];
+        run: () => void;
+    }>;
+    currentScope: {
+        func: string[];
+        temp: string[];
+        effects: string[];
+        uid: string;
+    } | null;
+}
+interface ExtensionMetadata {
+    __value: typeof __value;
+    __id: typeof __id;
+    __componentName: typeof __componentName;
+    __usableEnv: typeof __usableEnv;
+}
+type View<C extends Partial<ExtensionBaseViewContext> | never = never> = Brand<"View"> & {
+    [__value]: (context: C) => ExtensionElement | Promise<ExtensionElement>;
+    [__id]: string;
+};
+interface ExtensionSpec {
+    name: string;
+    description: string;
+    displayName: string;
+    permissions: string[];
+    runtime: string;
+    icon: string;
+    iconDark?: string;
+}
+interface ExtensionBlockActionSpec {
+    id: string;
+    label: string;
+    blocks: string[];
+    view: string;
+}
+interface ExtensionPageSpec {
+    mainView?: string;
+    sidePanelView?: string;
+}
+interface ExtensionElementSpec {
+    type: string;
+    view: string;
+}
+interface ExtensionRuntimeSpec {
+    onUninstall?: string;
+    onConfigure?: string;
+    configurationView?: string;
+    contentPieceView?: string;
+    blockActions?: ExtensionBlockActionSpec[];
+    page?: ExtensionPageSpec;
+    elements?: ExtensionElementSpec[];
+}
+interface Extension {
+    getMetadata: () => ExtensionMetadata;
+    getEnvironment: () => ExtensionEnvironment;
+    triggerEffects: (...dependencies: string[]) => Promise<void>;
+    generateRuntimeSpec: () => ExtensionRuntimeSpec;
+    generateView: <C extends ExtensionBaseViewContext>(id: string, context: C, uid: string) => Promise<ExtensionElement>;
+    removeScope: (id: string) => void;
+    runFunction: <C extends ExtensionBaseContext | never = never>(id: string, context: C, uid: string) => Promise<void>;
+}
+type BaseProps<P extends Record<string, any>> = {
+    [K in keyof P as Exclude<K, symbol>]?: P[K];
+};
+type BindableProps<P extends Record<string, any>, M extends string | never = never> = {
+    [K in keyof P as `bind:${Exclude<Exclude<K, symbol>, M>}`]?: Val<P[K]>;
+} & {
+    [K in keyof P as `bind:${Extract<Exclude<K, symbol>, M>}`]?: MutableVal<P[K]>;
+};
+type EventProps<E extends string | never> = {
+    [K in E as `on:${Exclude<K, symbol>}`]?: Func;
+};
+interface ExtensionBaseComponent<P extends Record<string, any> = Record<string, any>, E extends string | never = never, M extends string | never = never> {
+    (props: BaseProps<P> & BindableProps<P, M> & EventProps<E>): void;
+    [__componentName]: string;
+    [__props]: P;
+}
+interface ExtensionBaseComponents {
+    Content: ExtensionBaseComponent<{
+        allowed?: ExtensionContentType[];
+        initial?: string;
+        class?: string;
+        wrapperClass?: string;
+    }>;
+    Element: ExtensionBaseComponent<{
+        type: string;
+    }>;
+    View: ExtensionBaseComponent<{
+        class: string;
+    }>;
+    SidePanelHeader: ExtensionBaseComponent<{
+        defaultSection: string;
+        section: string;
+        sections: Array<{
+            label: string;
+            icon?: string;
+            id: string;
+            action?: ExtensionElement;
+        }>;
+    }, "back">;
+    SidePanelContent: ExtensionBaseComponent<{}>;
+    Field: ExtensionBaseComponent<{
+        type: string;
+        color: "base" | "contrast";
+        label: string;
+        textarea: boolean;
+        value?: string | boolean;
+        disabled: boolean;
+        placeholder: string;
+        optional: boolean;
+        options?: Array<{
+            label: string;
+            value: string;
+        }>;
+    }, "change", "value">;
+    Select: ExtensionBaseComponent<{
+        options: Array<{
+            label: string;
+            value: string;
+        }>;
+        value?: string;
+        class?: string;
+        placeholder?: string;
+        color?: "base" | "contrast";
+        wrapperClass?: string;
+    }, "change", "value">;
+    Tooltip: ExtensionBaseComponent<{
+        text: string;
+        class: string;
+        fixed: boolean;
+        side?: "top" | "bottom" | "left" | "right";
+    }>;
+    Button: ExtensionBaseComponent<{
+        color: "base" | "contrast" | "primary" | "danger" | "success";
+        text: "base" | "contrast" | "primary" | "soft" | "danger" | "success";
+        class: string;
+        loading: boolean;
+        disabled: boolean;
+        hover: boolean;
+        badge: boolean;
+        variant: "text" | "solid";
+        size: "small" | "medium" | "large";
+        target: string;
+        link: string;
+    }, "click">;
+    Card: ExtensionBaseComponent<{
+        color: "base" | "contrast" | "primary";
+        class: string;
+    }>;
+    Icon: ExtensionBaseComponent<{
+        path: string;
+        class: string;
+    }>;
+    IconButton: ExtensionBaseComponent<{
+        color: "base" | "contrast" | "primary";
+        text: "base" | "contrast" | "primary" | "soft";
+        path: string;
+        class: string;
+        loading: boolean;
+        disabled: boolean;
+    }, "click">;
+    CollapsibleSection: ExtensionBaseComponent<{
+        icon: string;
+        label: string;
+        action?: ExtensionElement;
+        color?: "base" | "primary";
+        defaultOpened?: boolean;
+    }>;
+    Switch: ExtensionBaseComponent<{}>;
+    Match: ExtensionBaseComponent<{
+        when?: ContextValue;
+    }>;
+    Show: ExtensionBaseComponent<{
+        when: ContextValue;
+    }>;
+    Text: ExtensionBaseComponent<{
+        content: ContextValue;
+    }>;
+}
+type ExtensionElement = {
+    slot: Array<ExtensionElement | string>;
+    component: string;
+    props?: Record<string, string | boolean | number>;
+};
+interface ExtensionRuntimeConfig<C extends ContextObject = ContextObject> {
+    onUninstall?: Func<ExtensionBaseContext<C>>;
+    onConfigure?: Func<ExtensionBaseContext<C>>;
+    configurationView?: View<ExtensionConfigurationViewContext<C>>;
+    contentPieceView?: View<ExtensionContentPieceViewContext<C>>;
+    blockActions?: Array<Omit<ExtensionBlockActionSpec, "view"> & {
+        view: View<ExtensionBlockActionViewContext<C>>;
+    }>;
+    elements?: Array<Omit<ExtensionElementSpec, "view"> & {
+        view: View<ExtensionElementViewContext<C, any>>;
+    }>;
+    page?: {
+        mainView?: View<ExtensionBaseViewContext<C>>;
+        sidePanelView?: View<ExtensionBaseViewContext<C>>;
+    };
+}
+declare const generateId: () => string;
+declare const isVal: <T extends ContextValue>(value: T | Val<T>) => value is Val<T>;
+declare const Components: ExtensionBaseComponents;
+declare function createTemp<T extends ContextValue>(initialValue: T): [MutableVal<T>, (value: T) => void];
+declare function createTemp<T extends ContextValue>(initialValue?: T): [MutableVal<T | undefined>, (value: T | undefined) => void];
+declare function effect<D extends Val[]>(run: () => void, dependencies: D, options?: {
+    initial?: boolean;
+}): void;
+declare const computed: (<O extends ContextValue>(compute: () => O, dependencies: Val[]) => Val<O>) & {
+    eq: (...values: Array<Val<ContextValue> | ContextValue>) => Val<boolean>;
+    neq: (...values: Array<Val<ContextValue> | ContextValue>) => Val<boolean>;
+    gt: (a: number | Val<number>, b: number | Val<number>) => Val<boolean>;
+    lt: (a: number | Val<number>, b: number | Val<number>) => Val<boolean>;
+    and: (...values: Array<Val<ContextValue> | ContextValue>) => Val<boolean>;
+    or: (...values: Array<Val<ContextValue> | ContextValue>) => Val<boolean>;
+    not: (value: Val<ContextValue> | ContextValue) => Val<boolean>;
+    add: (...values: Array<Val<number> | number>) => Val<number>;
+    join: (...values: Array<Val<string> | string>) => Val<string>;
+    sub: (...values: Val<number>[]) => Val<number>;
+    mul: (...values: Val<number>[]) => Val<number>;
+    div: (a: number | Val<number>, b: number | Val<number>) => Val<number>;
+    mod: (a: number | Val<number>, b: number | Val<number>) => Val<number>;
+    neg: (value: number | Val<number>) => Val<number>;
+    when: <T extends ContextValue, F extends ContextValue = undefined>(condition: ContextValue | Val<ContextValue>, ifTrue: T | Val<T>, ifFalse?: F | Val<F>) => F extends undefined ? Val<T | null> : Val<T>;
+};
+declare const createFunction: <C extends ExtensionBaseContext | never = never>(run: (context: C) => void) => Func<C>;
+declare const createElement: <C extends ExtensionBaseComponent<any>>(component: C, props: C[typeof __props], ...children: Array<ExtensionElement | string>) => ExtensionElement;
+declare const createFragment: (...children: Array<ExtensionElement | string>) => ExtensionElement;
+declare const createView: <C extends ExtensionBaseViewContext>(run: (context: C) => ExtensionElement) => View<C>;
+declare const createRuntime: <C extends ContextObject = ContextObject>(runtimeConfig: ExtensionRuntimeConfig<C>) => Extension;
+
+export { type Brand, Components, type ContextObject, type ContextValue, type Extension, type ExtensionBaseComponents, type ExtensionBaseContext, type ExtensionBaseViewContext, type ExtensionBlockActionSpec, type ExtensionBlockActionViewContext, type ExtensionConfigurationViewContext, type ExtensionContentPieceViewContext, type ExtensionContentType, type ExtensionElement, type ExtensionElementSpec, type ExtensionElementViewContext, type ExtensionEnvironment, type ExtensionMetadata, type ExtensionRuntimeSpec, type ExtensionSpec, type Func, type MutableVal, type Val, type View, computed, createElement, createFragment, createFunction, createRuntime, createTemp, createView, effect, generateId, isVal };