@freedam/picker 0.0.0-stage → 1.2.0

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+import { P as PickerSelectMode, R as RuleTree, S as SortField, a as SortDirection, b as PickerAssetType, c as PickerLocale, d as PickerTheme, e as PickerMode, f as PickerAsset, F as FreedamPickerError } from './element-D6ex-aQ4.js';
+export { E as ERROR_MESSAGES, g as FreedamPickerElement, h as FreedamPickerEventMap, H as HostCloseMessage, i as HostToPickerMessage, I as INLINE_MIN_HEIGHT, M as MAX_SELECTION, j as PICKER_ASSET_TYPES, k as PICKER_LOCALES, l as PICKER_MODES, m as PICKER_THEMES, n as PROTOCOL_VERSION, o as PickerCancelMessage, p as PickerDocument, q as PickerDocumentChoice, r as PickerDocumentFile, s as PickerDocumentForm, t as PickerErrorCode, u as PickerErrorMessage, v as PickerFileFormat, w as PickerFocusPoint, x as PickerFormat, y as PickerFrameMode, z as PickerImage, A as PickerImageChoice, B as PickerMessageBase, C as PickerMetadata, D as PickerMetadataValue, G as PickerOpenQuery, J as PickerReadyMessage, K as PickerResizeMessage, L as PickerSdkErrorCode, N as PickerSelectMessage, O as PickerServerErrorCode, Q as PickerSignInMessage, T as PickerSubtitle, U as PickerToHostMessage, V as PickerVideo, W as PickerVideoChoice, X as RuleFilter, Y as RuleGroup, Z as SDK_ERROR_CODES, _ as SERVER_ERROR_CODES, $ as SORT_DIRECTIONS, a0 as SORT_FIELDS } from './element-D6ex-aQ4.js';
+
+interface PickerOptions {
+    /** Host of the Freedam workspace, without scheme or path: `acme.example.com`. HTTPS is always used. */
+    workspace: string;
+    /** Public key of the integration, shown in the workspace's integration settings. */
+    integration: string;
+    /**
+     * Key of the integration's access without a Freedam account (`fdpk_…`),
+     * shown in the integration's settings when the access is on. With it,
+     * visitors without an account can browse and insert the integration's
+     * assets. Not a secret.
+     */
+    publicKey?: string;
+    /** Default `single`. */
+    select?: PickerSelectMode;
+    /** Most assets the person can choose, 1 to 50, with `select: 'multiple'`. */
+    max?: number;
+    /** Initial search text, 500 characters at most. */
+    q?: string;
+    /** Initial filters, applied on top of the integration's own rules. */
+    filters?: RuleTree;
+    sort?: {
+        by: SortField;
+        direction?: SortDirection;
+    };
+    /** GAIDs selected when the picker opens; GAIDs the person cannot see are ignored. */
+    preselected?: string[];
+    /**
+     * Asset types the picker offers, among the integration's own: `['image']`
+     * for an image field. A type the integration does not offer is ignored.
+     * Default: every type of the integration.
+     */
+    types?: PickerAssetType[];
+    /** Interface language; default: the person's own setting. */
+    locale?: PickerLocale;
+    theme?: PickerTheme;
+    /**
+     * Default `popup`: a window on the workspace host. `tab` opens it in a
+     * new tab of the browser instead. `modal` shows the picker in an iframe
+     * over the page (full screen below 640 pixels wide); `inline` shows it
+     * in an iframe inside `container`. When the browser does not let the
+     * iframe sign in, the SDK offers to continue in a window.
+     */
+    mode?: PickerMode;
+    /** Element that receives the picker's iframe, required with `mode: 'inline'` and only then. */
+    container?: HTMLElement;
+    onReady?: () => void;
+    onSelect?: (assets: PickerAsset[]) => void;
+    onCancel?: () => void;
+    onError?: (error: FreedamPickerError) => void;
+    onClose?: () => void;
+}
+
+type PickerResult = PickerAsset[] | null;
+/**
+ * Opens the picker and resolves with the inserted assets, or with `null`
+ * when the person cancels or closes it.
+ *
+ * Call it from a click handler, with no `await` before it: browsers block
+ * windows opened outside a user gesture. Invalid options reject with
+ * `invalid_options` before anything opens. While a picker of this page is
+ * open, another call brings it to the front and returns the same promise.
+ *
+ * In the `popup` and `tab` modes the picker runs in a window of its own,
+ * a popup or a new tab of the browser.
+ *
+ * In the `modal` and `inline` modes the picker runs in an iframe. When the
+ * iframe cannot sign in (`auth_required`) or the picker page sends nothing
+ * within READY_TIMEOUT_MS, the iframe gives way to an "Open Freedam"
+ * button that opens the picker in a window with the same options; the
+ * promise then settles with the outcome of that window.
+ */
+declare function open(options: PickerOptions): Promise<PickerResult>;
+
+/** Version of this SDK, equal to `version` in package.json (checked by tests/version.test.ts). */
+declare const VERSION = "1.2.0";
+
+export { FreedamPickerError, PickerAsset, PickerAssetType, PickerLocale, PickerMode, type PickerOptions, PickerSelectMode, PickerTheme, RuleTree, SortDirection, SortField, VERSION, open };

package/dist/index.js

@@ -0,0 +1,2 @@
+import{a as e,b as r,c as o,d as i,e as c,f as t,g as P,h as k,i as s,j as E,k as a,l as S,m as R,n as m}from"./chunk-SF2R2FAB.js";var p="1.2.0";export{o as ERROR_MESSAGES,i as FreedamPickerError,k as INLINE_MIN_HEIGHT,t as MAX_SELECTION,s as PICKER_ASSET_TYPES,E as PICKER_LOCALES,P as PICKER_MODES,a as PICKER_THEMES,c as PROTOCOL_VERSION,r as SDK_ERROR_CODES,e as SERVER_ERROR_CODES,R as SORT_DIRECTIONS,S as SORT_FIELDS,p as VERSION,m as open};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["/** Version of this SDK, equal to `version` in package.json (checked by tests/version.test.ts). */\nexport const VERSION = '1.2.0';\n"],"mappings":"mIACO,IAAMA,EAAU","names":["VERSION"]}

package/dist/picker.global.js

@@ -0,0 +1 @@
+"use strict";(()=>{var pe=["origin_denied","feature_unavailable","integration_suspended","integration_unavailable","insert_failed","auth_required","guest_access_unavailable"];var W={origin_denied:"This page is not allowed to open the picker: the integration does not exist or does not list this origin.",feature_unavailable:"The asset picker is not available on this workspace.",integration_suspended:"This integration is suspended.",integration_unavailable:"This integration cannot be used: its profile or publication channel is missing or disabled.",insert_failed:"The selected assets could not be inserted.",auth_required:"The picker cannot run in an iframe of this page: the person continues in a separate window.",guest_access_unavailable:"This integration does not allow access without an account.",popup_blocked:"The browser blocked the picker window. Call open() from a click handler.",invalid_options:"Invalid picker options."},B=["insert_failed","guest_access_unavailable"];function q(e){return pe.includes(e)}var m=class extends Error{constructor(t,r){super(r===void 0?W[t]:`${W[t]} ${r}`),this.name="FreedamPickerError",this.code=t}};var M="freedam-picker",j="/picker/";var G=["popup","modal","inline","tab"];var F=["image","video","document"],X=["single","multiple"],R=["en","fr","de","es","pt-BR","zh-CN"],Y=["light","dark","auto"],I=["created_at","updated_at","title","original_filename","size","relevance"],J=["asc","desc"];var me=["onReady","onSelect","onCancel","onError","onClose"],ge=/^fdpk_[A-Za-z0-9]{32}$/,Ee=/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)*(?::\d{1,5})?$/i;function a(e){return new m("invalid_options",e)}function x(e,t){return e.includes(t)}function N(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function ke(e){return typeof HTMLElement<"u"&&e instanceof HTMLElement}function te(e){if(!N(e))throw a("open() expects an options object.");if(typeof e.workspace!="string"||!Ee.test(e.workspace)||!ye(e.workspace))throw a('`workspace` must be the host of the workspace, without scheme or path, e.g. "acme.example.com".');if(typeof e.integration!="string"||!/^\S+$/.test(e.integration))throw a("`integration` must be the key of the integration, without spaces.");if(e.publicKey!==void 0&&(typeof e.publicKey!="string"||!ge.test(e.publicKey)))throw a('`publicKey` must be the key of the access without an account: "fdpk_" followed by 32 letters and digits.');if(e.select!==void 0&&!x(X,e.select))throw a('`select` must be "single" or "multiple".');if(e.max!==void 0){if(e.select!=="multiple")throw a('`max` requires `select: "multiple"`.');if(typeof e.max!="number"||!Number.isInteger(e.max)||e.max<1||e.max>50)throw a(`\`max\` must be an integer from 1 to ${50}.`)}if(e.q!==void 0&&(typeof e.q!="string"||e.q.length>500))throw a(`\`q\` must be a string of ${500} characters at most.`);if(e.filters!==void 0){if(!N(e.filters))throw a("`filters` must be a filter or group object.");try{JSON.stringify(e.filters)}catch{throw a("`filters` must be serializable to JSON.")}}if(e.sort!==void 0){if(!N(e.sort)||!x(I,e.sort.by))throw a(`\`sort.by\` must be one of ${I.join(", ")}.`);if(e.sort.direction!==void 0&&!x(J,e.sort.direction))throw a('`sort.direction` must be "asc" or "desc".')}if(e.preselected!==void 0){let t=e.preselected;if(!Array.isArray(t)||!t.every(r=>typeof r=="string"&&r!==""&&!r.includes(",")))throw a("`preselected` must be an array of GAIDs.")}if(e.types!==void 0){let t=e.types;if(!Array.isArray(t)||t.length===0||!t.every(r=>x(F,r)))throw a(`\`types\` must be a non-empty array of ${F.join(", ")}.`)}if(e.locale!==void 0&&!x(R,e.locale))throw a(`\`locale\` must be one of ${R.join(", ")}.`);if(e.theme!==void 0&&!x(Y,e.theme))throw a('`theme` must be "light", "dark" or "auto".');if(e.mode!==void 0&&!x(G,e.mode))throw a('`mode` must be "popup", "tab", "modal" or "inline".');if(e.mode==="inline"){if(!ke(e.container)||!e.container.isConnected)throw a('`mode: "inline"` requires `container`, an element of the page.')}else if(e.container!==void 0)throw a('`container` requires `mode: "inline"`.');for(let t of me)if(e[t]!==void 0&&typeof e[t]!="function")throw a(`\`${t}\` must be a function.`)}function ye(e){try{return v(e),!0}catch{return!1}}function v(e){return new URL(`https://${e}`).origin}function re(e){if(!/^https?:\/\//.test(e))throw a("The host page must be served over HTTP or HTTPS.");return e}function ne(){let e=new Uint8Array(16);crypto.getRandomValues(e);let t="";for(let r of e)t+=String.fromCharCode(r);return btoa(t).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function D(e,t,r,l=e.mode??"popup"){let s=new URL(`${j}${encodeURIComponent(e.integration)}`,v(e.workspace)),n=s.searchParams;n.set("protocol",String(1)),n.set("origin",t),n.set("channel",r),n.set("mode",l),n.set("select",e.select??"single"),e.max!==void 0&&n.set("max",String(e.max)),e.publicKey!==void 0&&n.set("public_key",e.publicKey),e.q!==void 0&&e.q!==""&&n.set("q",e.q),e.filters!==void 0&&n.set("filters",JSON.stringify(e.filters)),e.sort!==void 0&&(n.set("sort_by",e.sort.by),e.sort.direction!==void 0&&n.set("sort_direction",e.sort.direction)),e.preselected!==void 0&&e.preselected.length>0&&n.set("preselected",e.preselected.join(",")),e.types!==void 0&&n.set("types",[...new Set(e.types)].join(",")),e.locale!==void 0&&n.set("locale",e.locale),e.theme!==void 0&&n.set("theme",e.theme);let i=s.toString();if(i.length>6e3)throw a(`The picker URL would exceed ${6e3} characters: shorten \`filters\`, \`q\` or \`preselected\`.`);return i}var Pe=1100,be=760,xe=1e4,we="2147483000",Se={en:{message:"Freedam cannot be shown in this page. Continue in a separate window.",open:"Open Freedam",cancel:"Cancel",close:"Close"},fr:{message:"Freedam ne peut pas s\u2019afficher dans cette page. Continuez dans une fen\xEAtre s\xE9par\xE9e.",open:"Ouvrir Freedam",cancel:"Annuler",close:"Fermer"},de:{message:"Freedam kann auf dieser Seite nicht angezeigt werden. Fahren Sie in einem separaten Fenster fort.",open:"Freedam \xF6ffnen",cancel:"Abbrechen",close:"Schlie\xDFen"},es:{message:"Freedam no se puede mostrar en esta p\xE1gina. Contin\xFAe en una ventana aparte.",open:"Abrir Freedam",cancel:"Cancelar",close:"Cerrar"},"pt-BR":{message:"O Freedam n\xE3o pode ser exibido nesta p\xE1gina. Continue em uma janela separada.",open:"Abrir o Freedam",cancel:"Cancelar",close:"Fechar"},"zh-CN":{message:"\u65E0\u6CD5\u5728\u6B64\u9875\u9762\u4E2D\u663E\u793A Freedam\u3002\u8BF7\u5728\u5355\u72EC\u7684\u7A97\u53E3\u4E2D\u7EE7\u7EED\u3002",open:"\u6253\u5F00 Freedam",cancel:"\u53D6\u6D88",close:"\u5173\u95ED"}};function Te(e){let t=[e,document.documentElement.lang,typeof navigator>"u"?void 0:navigator.language];for(let r of t){if(typeof r!="string"||r==="")continue;let l=R.find(i=>i.toLowerCase()===r.toLowerCase());if(l!==void 0)return l;let s=r.split("-")[0].toLowerCase(),n=R.find(i=>i.split("-")[0]===s);if(n!==void 0)return n}return"en"}function h(e,t={}){let r=document.createElement(e);return Object.assign(r.style,t),r}function ie(e,t){let r=h("button",{font:"inherit",fontWeight:"600",padding:"10px 18px",borderRadius:"8px",cursor:"pointer",border:t?"1px solid #111827":"1px solid #d1d5db",background:t?"#111827":"#ffffff",color:t?"#ffffff":"#111827"});return r.type="button",r.textContent=e,r}function oe(e){let t=Se[Te(e.locale)],r=document.activeElement instanceof HTMLElement?document.activeElement:null,l=[],s=!1,n=h("iframe",{display:"block",width:"100%",height:"100%",border:"0",background:"#ffffff"});n.src=e.url,n.name=`freedam-picker-${e.channel}`,n.title="Freedam",n.setAttribute("data-freedam-picker",e.mode);let i,c;if(e.mode==="modal"){i=h("div",{position:"fixed",top:"0",right:"0",bottom:"0",left:"0",zIndex:we,display:"flex",alignItems:"center",justifyContent:"center",boxSizing:"border-box",background:"rgba(17, 24, 39, 0.6)"}),i.setAttribute("role","dialog"),i.setAttribute("aria-modal","true"),i.setAttribute("aria-label","Freedam"),i.setAttribute("data-freedam-picker-overlay",""),c=h("div",{position:"relative",width:"100%",height:"100%",overflow:"hidden",background:"#ffffff",boxShadow:"0 24px 48px rgba(0, 0, 0, 0.3)"});let d=h("button",{position:"absolute",top:"6px",right:"8px",width:"32px",height:"32px",padding:"0",border:"0",borderRadius:"16px",background:"transparent",color:"#ffffff",fontSize:"24px",lineHeight:"32px",cursor:"pointer"});d.type="button",d.textContent="\xD7",d.setAttribute("aria-label",t.close),d.setAttribute("data-freedam-picker-close",""),d.addEventListener("click",()=>e.onDismiss()),i.append(c,d);let o=typeof window.matchMedia=="function"?window.matchMedia(`(max-width: ${640-.02}px)`):null,p=()=>{let f=o?.matches===!0;Object.assign(i.style,{padding:f?"44px 0 0":"48px 24px 24px"}),Object.assign(c.style,{maxWidth:f?"none":`${Pe}px`,maxHeight:f?"none":`${be}px`,borderRadius:f?"0":"12px"})};p(),o!==null&&(o.addEventListener("change",p),l.push(()=>o.removeEventListener("change",p)));let u=f=>{if(f.key==="Escape"){e.onDismiss();return}if(f.key!=="Tab")return;let S=Array.from(i.querySelectorAll("button, iframe")),k=S[0],T=S[S.length-1],_=document.activeElement;k===void 0||T===void 0||(!(_ instanceof Node)||!i.contains(_)?(f.preventDefault(),k.focus()):f.shiftKey&&_===k?(f.preventDefault(),T.focus()):!f.shiftKey&&_===T&&(f.preventDefault(),k.focus()))};document.addEventListener("keydown",u),l.push(()=>document.removeEventListener("keydown",u));let E=document.documentElement,O=E.style.overflow;E.style.overflow="hidden",l.push(()=>{E.style.overflow=O}),c.append(n),document.body.append(i)}else i=h("div",{display:"block",width:"100%",height:"100%",minHeight:`${480}px`}),i.setAttribute("data-freedam-picker-inline",""),c=i,n.style.minHeight=`${480}px`,c.append(n),e.container.append(i);e.mode==="modal"&&n.focus();let b=()=>c.querySelector("[data-freedam-picker-open]");return{mode:e.mode,target:()=>n.isConnected?n.contentWindow:null,isClosed:()=>s||!i.isConnected,focus:()=>(b()??n).focus(),close:(d=!0)=>{if(s)return;s=!0;let o=n.isConnected?n.contentWindow:null;if(o!==null){let p={source:M,protocol:1,channel:e.channel,type:"close"};o.postMessage(p,e.origin)}i.remove();for(let p of l)p();d&&e.mode==="modal"&&r!==null&&r.isConnected&&r.focus()},showFallback:()=>{if(s||b()!==null)return;let d=h("div",{display:"flex",flexDirection:"column",alignItems:"center",justifyContent:"center",gap:"16px",boxSizing:"border-box",width:"100%",height:"100%",minHeight:e.mode==="inline"?`${480}px`:"0",padding:"24px",background:"#ffffff",color:"#111827",fontFamily:'system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',fontSize:"15px",lineHeight:"1.5",textAlign:"center"});d.setAttribute("data-freedam-picker-fallback","");let o=h("p",{margin:"0",maxWidth:"420px"});o.textContent=t.message;let p=h("div",{display:"flex",flexWrap:"wrap",justifyContent:"center",gap:"8px"}),u=ie(t.open,!0);u.setAttribute("data-freedam-picker-open",""),u.addEventListener("click",()=>e.onOpenWindow());let E=ie(t.cancel,!1);E.setAttribute("data-freedam-picker-cancel",""),E.addEventListener("click",()=>e.onDismiss()),p.append(u,E),d.append(o,p),n.remove(),c.append(d),e.mode==="modal"&&u.focus()},resize:d=>{e.mode!=="inline"||!Number.isFinite(d)||(n.style.height=`${Math.round(Math.min(xe,Math.max(480,d)))}px`,i.style.height="auto")}}}function K(e,t){let r=Math.min(1100,window.screen.availWidth||1100),l=Math.min(760,window.screen.availHeight||760),s=Math.round(window.screenX+(window.outerWidth-r)/2),n=Math.round(window.screenY+(window.outerHeight-l)/2);return ae(window.open(e,`freedam-picker-${t}`,`popup=yes,width=${r},height=${l},left=${s},top=${n}`))}function se(e,t){return ae(window.open(e,`freedam-picker-${t}`))}function ae(e){return e?{target:()=>e,isClosed:()=>e.closed,focus:()=>e.focus(),close:()=>e.close()}:null}var _e=500,Re=1e3,Ce=15e3,w=null;function Oe(){return navigator.userActivation?.isActive===!0}function P(e,...t){if(typeof e=="function")try{e(...t)}catch(r){setTimeout(()=>{throw r})}}function Me(e,t){if(typeof e!="object"||e===null)return!1;let r=e;return r.source===M&&r.protocol===1&&r.channel===t&&typeof r.type=="string"}function A(e){if(w!==null&&!w.surface().isClosed())return w.surface().focus(),w.promise;let t,r,l,s;try{te(e),l=v(e.workspace),s=ne();let o=re(window.location.origin);t=D(e,o,s),r=D(e,o,s,"popup")}catch(o){if(!(o instanceof m))throw o;return P(e?.onError,o),Promise.reject(o)}let n=e.mode??"popup",i,c=null,b={dismiss:()=>{},openWindow:()=>{}};if(n==="popup"||n==="tab"){let o=n==="tab"?se(t,s):K(t,s);if(o===null){let p=new m("popup_blocked");return P(e.onError,p),Promise.reject(p)}i=o}else c=oe({url:t,channel:s,origin:l,mode:n,container:e.container,locale:e.locale,onDismiss:()=>b.dismiss(),onOpenWindow:()=>b.openWindow()}),i=c;let d=new Promise((o,p)=>{let u=!1,E=!1,O,f,S=()=>{if(c!==null){c.close(),k();return}O=setTimeout(()=>{i.isClosed()||i.close()},Re)},k=()=>{i.isClosed()&&(c?.close(),clearInterval(fe),clearTimeout(O),clearTimeout(f),window.removeEventListener("message",U),w?.promise===d&&(w=null),u||(u=!0,P(e.onCancel),o(null)),P(e.onClose))},T=()=>{if(c===null||u)return!1;let y=K(r,s);return y===null?!1:(clearTimeout(f),c.close(!1),c=null,i=y,!0)};b.dismiss=()=>{i.close(),k()},b.openWindow=()=>{if(!T()&&!u){u=!0;let y=new m("popup_blocked");P(e.onError,y),p(y),i.close(),k()}};let _=()=>{Oe()&&T()||c?.showFallback()},U=y=>{if(u||y.origin!==l||y.source!==i.target())return;let g=y.data;if(Me(g,s))switch(clearTimeout(f),g.type){case"ready":E||(E=!0,P(e.onReady));break;case"resize":typeof g.height=="number"&&c?.resize(g.height);break;case"select":if(!Array.isArray(g.assets))return;u=!0,P(e.onSelect,g.assets),o(g.assets),S();break;case"cancel":u=!0,P(e.onCancel),o(null),S();break;case"error":{if(!q(g.code))return;if(g.code==="auth_required"){_();return}let z=new m(g.code);P(e.onError,z),B.includes(g.code)||(u=!0,p(z));break}}},fe=setInterval(k,_e);c!==null&&(f=setTimeout(()=>{u||c?.showFallback()},Ce)),window.addEventListener("message",U)});return w={surface:()=>i,promise:d},d}var ce="freedam-picker",ve="[data-freedam-picker-inline], [data-freedam-picker-overlay]",Le=typeof HTMLElement>"u"?class{}:HTMLElement,$=class extends Le{constructor(){super(),this.addEventListener("click",t=>{t.target instanceof Element&&t.target.closest(ve)!==null||this.open().catch(()=>{})})}get filters(){return this.filtersValue}set filters(t){this.filtersValue=t}get preselected(){return this.preselectedValue}set preselected(t){this.preselectedValue=t}get container(){return this.containerValue}set container(t){this.containerValue=t}open(){let t;try{t=this.options()}catch(r){return r instanceof m&&this.emit("freedam-error",{error:r}),Promise.reject(r)}return A(t)}options(){let t=i=>this.getAttribute(i)??void 0,r=t("max"),l=t("sort-by"),s=t("sort-direction"),n=t("container");return{workspace:t("workspace"),integration:t("integration"),publicKey:t("public-key"),select:t("select"),max:r===void 0?void 0:Number(r),q:t("q"),filters:this.filtersValue??Ae(t("filters")),sort:l===void 0&&s===void 0?void 0:{by:l,direction:s},preselected:this.preselectedValue??le(t("preselected")),types:He(le(t("types"))),locale:t("locale"),theme:t("theme"),mode:t("mode"),container:this.containerValue??(n===void 0?void 0:document.getElementById(n)??void 0),onReady:()=>this.emit("freedam-ready",{}),onSelect:i=>this.emit("freedam-select",{assets:i}),onCancel:()=>this.emit("freedam-cancel",{}),onError:i=>this.emit("freedam-error",{error:i}),onClose:()=>this.emit("freedam-close",{})}}emit(t,r){this.dispatchEvent(new CustomEvent(t,{detail:r,bubbles:!0,composed:!0}))}};function Ae(e){if(e!==void 0)try{return JSON.parse(e)}catch{throw new m("invalid_options","The `filters` attribute must be JSON.")}}function le(e){return e?.split(",").map(t=>t.trim()).filter(t=>t!=="")}function He(e){return e===void 0||e.length===0?void 0:e}function V(){typeof customElements<"u"&&customElements.get(ce)===void 0&&customElements.define(ce,$)}V();var de="1.2.0";var ue=window,H=ue.Freedam,Fe=typeof H=="object"&&H!==null||typeof H=="function"?H:ue.Freedam={};Fe.picker={open:A,FreedamPickerError:m,VERSION:de};V();})();

package/package.json

@@ -1,6 +1,70 @@
 {
-  "name": "@freedam/picker",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@freedam/picker",
+    "version": "1.2.0",
+    "description": "Embeddable asset picker for Freedam workspaces: let people choose assets from Freedam inside your own application",
+    "homepage": "https://freedam.io/docs/api-picker-reference",
+    "bugs": {
+        "url": "https://freedam.io/docs/api-picker-reference",
+        "email": "hello@freedam.io"
+    },
+    "type": "module",
+    "main": "./dist/index.cjs",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "sideEffects": [
+        "./dist/element.js",
+        "./dist/picker.global.js"
+    ],
+    "exports": {
+        ".": {
+            "import": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/index.js"
+            },
+            "require": {
+                "types": "./dist/index.d.cts",
+                "default": "./dist/index.cjs"
+            }
+        },
+        "./element": {
+            "types": "./dist/element.d.ts",
+            "default": "./dist/element.js"
+        },
+        "./schema.json": "./schema/payload.schema.json"
+    },
+    "files": [
+        "dist",
+        "schema",
+        "README.md",
+        "CHANGELOG.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "scripts": {
+        "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsup",
+        "test": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "size": "node scripts/check-size.mjs",
+        "verify": "node scripts/verify-global-build.mjs",
+        "publish:cdn": "node scripts/publish-cdn.mjs",
+        "prepublishOnly": "npm run typecheck && npm run test && npm run build && npm run size && npm run verify"
+    },
+    "keywords": [
+        "freedam",
+        "dam",
+        "digital-asset-management",
+        "asset-picker",
+        "media-picker"
+    ],
+    "license": "MIT",
+    "devDependencies": {
+        "jsdom": "^26.1.0",
+        "tsup": "^8.4.0",
+        "typescript": "^5.7.3",
+        "vitest": "^3.0.0"
+    }
+}

package/schema/payload.schema.json

@@ -0,0 +1,316 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "title": "Freedam Picker asset",
+    "description": "One asset inserted from the Freedam Picker, as the picker sends it to the host page in a `select` message. Keys are snake_case, like the Freedam API.",
+    "oneOf": [
+        { "$ref": "#/$defs/image" },
+        { "$ref": "#/$defs/video" },
+        { "$ref": "#/$defs/document" }
+    ],
+    "$defs": {
+        "url": {
+            "type": "string",
+            "minLength": 1
+        },
+        "nullable_text": {
+            "type": ["string", "null"]
+        },
+        "dimension": {
+            "description": "Size of the original file, in pixels; null when unknown, e.g. for a document without dimensions.",
+            "type": ["integer", "null"],
+            "minimum": 1
+        },
+        "url_template": {
+            "description": "Signed URL of the asset's image (the image itself, a video's poster, a document's first page) with the literal text {options} where the URL options go.",
+            "type": "string",
+            "pattern": "\\{options\\}"
+        },
+        "widths": {
+            "description": "Widths the url_template serves with w=, in pixels, smallest first: the channel's width tiers up to the original's width. The smallest tier when the original is narrower than it; every tier when the original's width is unknown. A width above the channel maximum answers 400.",
+            "type": "array",
+            "items": { "type": "integer", "minimum": 1 },
+            "uniqueItems": true
+        },
+        "format": {
+            "description": "A named format of the publication channel, offered by the integration's profile.",
+            "type": "object",
+            "required": ["name", "ratio", "url"],
+            "properties": {
+                "name": { "description": "Name used in URL options (fmt=hero).", "type": "string", "minLength": 1 },
+                "ratio": { "description": "Width to height, e.g. 16:9.", "type": "string" },
+                "url": { "$ref": "#/$defs/url" }
+            },
+            "additionalProperties": false
+        },
+        "formats": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/format" }
+        },
+        "focus_point": {
+            "description": "Position from the top-left corner, in percent; null when the asset has none.",
+            "type": ["object", "null"],
+            "required": ["x", "y"],
+            "properties": {
+                "x": { "type": "number", "minimum": 0, "maximum": 100 },
+                "y": { "type": "number", "minimum": 0, "maximum": 100 }
+            },
+            "additionalProperties": false
+        },
+        "metadata_value": {
+            "description": "A value as the Freedam API returns it: a list for several values, a map of language code to text for a multilingual field, a YYYY-MM-DD string for a date.",
+            "type": ["string", "number", "boolean", "null", "array", "object"],
+            "items": { "type": ["string", "number", "boolean"] },
+            "additionalProperties": { "type": "string" }
+        },
+        "metadata": {
+            "description": "Fields the integration's profile exposes. An exposed field is always present, null when empty or hidden from the person who inserted the asset.",
+            "type": "object",
+            "properties": {
+                "title": { "$ref": "#/$defs/nullable_text" },
+                "description": { "$ref": "#/$defs/nullable_text" },
+                "alt": { "$ref": "#/$defs/nullable_text" },
+                "credit": { "$ref": "#/$defs/nullable_text" },
+                "copyright": { "$ref": "#/$defs/nullable_text" },
+                "keywords": {
+                    "type": ["array", "null"],
+                    "items": { "type": "string" }
+                },
+                "custom": {
+                    "description": "Workspace metadata fields, by field key. Dates are YYYY-MM-DD.",
+                    "type": "object",
+                    "additionalProperties": { "$ref": "#/$defs/metadata_value" }
+                }
+            },
+            "additionalProperties": false
+        },
+        "image_choice": {
+            "type": "object",
+            "required": ["format", "file_format"],
+            "properties": {
+                "format": {
+                    "description": "Format name, or null for the original ratio.",
+                    "type": ["string", "null"]
+                },
+                "file_format": {
+                    "description": "Image file format, or null to let the browser negotiate it.",
+                    "enum": ["avif", "webp", "jpeg", null]
+                }
+            },
+            "additionalProperties": false
+        },
+        "subtitle": {
+            "type": "object",
+            "required": ["language", "label", "url", "is_default"],
+            "properties": {
+                "language": { "type": "string", "minLength": 1 },
+                "label": { "type": "string" },
+                "url": { "$ref": "#/$defs/url" },
+                "is_default": { "type": "boolean" }
+            },
+            "additionalProperties": false
+        },
+        "video_choice": {
+            "type": "object",
+            "required": ["autoplay", "muted", "loop", "controls", "start", "subtitle_language"],
+            "properties": {
+                "autoplay": { "type": "boolean" },
+                "muted": { "description": "Always true when autoplay is true.", "type": "boolean" },
+                "loop": { "type": "boolean" },
+                "controls": { "type": "boolean" },
+                "start": { "description": "Start position, in seconds.", "type": "number", "minimum": 0 },
+                "subtitle_language": {
+                    "description": "Subtitles shown when playback starts: null for the video's default track, \"off\" for none, otherwise the language code of one of `subtitles`.",
+                    "type": ["string", "null"],
+                    "minLength": 1
+                }
+            },
+            "additionalProperties": false
+        },
+        "document_choice": {
+            "type": "object",
+            "required": ["form", "file"],
+            "properties": {
+                "form": {
+                    "description": "What the host inserts: a link to url, the preview_url image linked to url, or embed_html.",
+                    "enum": ["link", "thumbnail", "viewer"]
+                },
+                "file": {
+                    "description": "Which file url delivers.",
+                    "enum": ["original", "pdf"]
+                }
+            },
+            "additionalProperties": false
+        },
+        "image": {
+            "type": "object",
+            "required": [
+                "gaid",
+                "version",
+                "type",
+                "mime_type",
+                "file_size",
+                "width",
+                "height",
+                "url",
+                "url_template",
+                "widths",
+                "formats",
+                "focus_point",
+                "thumbnail_url",
+                "metadata",
+                "usage_id",
+                "usage_token",
+                "choice"
+            ],
+            "properties": {
+                "gaid": { "type": "string", "minLength": 1 },
+                "version": { "type": "integer", "minimum": 1 },
+                "type": { "const": "image" },
+                "mime_type": { "type": "string", "minLength": 1 },
+                "file_size": { "type": "integer", "minimum": 0 },
+                "width": { "$ref": "#/$defs/dimension" },
+                "height": { "$ref": "#/$defs/dimension" },
+                "url": { "$ref": "#/$defs/url" },
+                "url_template": { "$ref": "#/$defs/url_template" },
+                "widths": { "$ref": "#/$defs/widths" },
+                "formats": { "$ref": "#/$defs/formats" },
+                "focus_point": { "$ref": "#/$defs/focus_point" },
+                "thumbnail_url": { "$ref": "#/$defs/url" },
+                "metadata": { "$ref": "#/$defs/metadata" },
+                "usage_id": { "type": "string", "minLength": 1 },
+                "usage_token": { "type": "string", "minLength": 1 },
+                "choice": { "$ref": "#/$defs/image_choice" }
+            },
+            "additionalProperties": false
+        },
+        "video": {
+            "type": "object",
+            "required": [
+                "gaid",
+                "version",
+                "type",
+                "mime_type",
+                "file_size",
+                "width",
+                "height",
+                "url",
+                "url_template",
+                "widths",
+                "formats",
+                "focus_point",
+                "thumbnail_url",
+                "metadata",
+                "usage_id",
+                "usage_token",
+                "player_url",
+                "embed_html",
+                "stream_url",
+                "poster_url",
+                "duration",
+                "subtitles",
+                "choice"
+            ],
+            "properties": {
+                "gaid": { "type": "string", "minLength": 1 },
+                "version": { "type": "integer", "minimum": 1 },
+                "type": { "const": "video" },
+                "mime_type": { "type": "string", "minLength": 1 },
+                "file_size": { "type": "integer", "minimum": 0 },
+                "width": { "$ref": "#/$defs/dimension" },
+                "height": { "$ref": "#/$defs/dimension" },
+                "url": { "description": "Equal to player_url.", "$ref": "#/$defs/url" },
+                "url_template": { "$ref": "#/$defs/url_template" },
+                "widths": { "$ref": "#/$defs/widths" },
+                "formats": { "$ref": "#/$defs/formats" },
+                "focus_point": { "$ref": "#/$defs/focus_point" },
+                "thumbnail_url": { "$ref": "#/$defs/url" },
+                "metadata": { "$ref": "#/$defs/metadata" },
+                "usage_id": { "type": "string", "minLength": 1 },
+                "usage_token": { "type": "string", "minLength": 1 },
+                "player_url": { "$ref": "#/$defs/url" },
+                "embed_html": { "description": "Responsive <iframe> of player_url.", "type": "string", "minLength": 1 },
+                "stream_url": { "description": "HLS manifest.", "$ref": "#/$defs/url" },
+                "poster_url": { "$ref": "#/$defs/url" },
+                "duration": { "description": "In seconds; null when unknown.", "type": ["number", "null"], "minimum": 0 },
+                "subtitles": {
+                    "type": "array",
+                    "items": { "$ref": "#/$defs/subtitle" }
+                },
+                "choice": { "$ref": "#/$defs/video_choice" }
+            },
+            "additionalProperties": false
+        },
+        "document": {
+            "type": "object",
+            "required": [
+                "gaid",
+                "version",
+                "type",
+                "mime_type",
+                "file_size",
+                "width",
+                "height",
+                "url",
+                "url_template",
+                "widths",
+                "formats",
+                "focus_point",
+                "thumbnail_url",
+                "metadata",
+                "usage_id",
+                "usage_token",
+                "download_url",
+                "pdf_url",
+                "preview_url",
+                "viewer_url",
+                "embed_html",
+                "page_count",
+                "extension",
+                "choice"
+            ],
+            "properties": {
+                "gaid": { "type": "string", "minLength": 1 },
+                "version": { "type": "integer", "minimum": 1 },
+                "type": { "const": "document" },
+                "mime_type": { "type": "string", "minLength": 1 },
+                "file_size": { "type": "integer", "minimum": 0 },
+                "width": { "$ref": "#/$defs/dimension" },
+                "height": { "$ref": "#/$defs/dimension" },
+                "url": { "description": "download_url or pdf_url, as choice.file says.", "$ref": "#/$defs/url" },
+                "url_template": { "$ref": "#/$defs/url_template" },
+                "widths": { "$ref": "#/$defs/widths" },
+                "formats": { "$ref": "#/$defs/formats" },
+                "focus_point": { "$ref": "#/$defs/focus_point" },
+                "thumbnail_url": { "$ref": "#/$defs/url" },
+                "metadata": { "$ref": "#/$defs/metadata" },
+                "usage_id": { "type": "string", "minLength": 1 },
+                "usage_token": { "type": "string", "minLength": 1 },
+                "download_url": { "$ref": "#/$defs/url" },
+                "pdf_url": {
+                    "description": "Equal to download_url for a PDF; null when no PDF version exists.",
+                    "type": ["string", "null"],
+                    "minLength": 1
+                },
+                "preview_url": {
+                    "description": "First page, served as an image; null when the document has no preview.",
+                    "type": ["string", "null"],
+                    "minLength": 1
+                },
+                "viewer_url": {
+                    "description": "Page-by-page viewer; null when no PDF version exists.",
+                    "type": ["string", "null"],
+                    "minLength": 1
+                },
+                "embed_html": {
+                    "description": "Responsive <iframe> of viewer_url; null when no PDF version exists.",
+                    "type": ["string", "null"],
+                    "minLength": 1
+                },
+                "page_count": { "type": ["integer", "null"], "minimum": 1 },
+                "extension": { "type": "string", "minLength": 1 },
+                "choice": { "$ref": "#/$defs/document_choice" }
+            },
+            "additionalProperties": false
+        }
+    }
+}