@plurnk/plurnk-service 1.3.12 → 1.4.0

package/dist/schemes/_entry-send.js

@@ -1,18 +1,17 @@
 // Shared SEND dispatcher for entry-bearing schemes. Schemes interpret
-// status codes per SPEC §send-dispatch. v0 handles 410 (Gone, delete the resource)
+// status codes per SPEC {§send-dispatch}. v0 handles 410 (Gone, delete the resource)
 // and 499 (Client Closed Request, cancel active subscription).
 import Owner from "../core/Owner.js";
-import { decodePathParens } from "../core/path-decode.js";
+import { entryPathnameOf, renderAddress } from "../core/plurnk-uri.js";
 import EntryCrud from "./_entry-crud.js";
 import ChannelWrite from "../core/ChannelWrite.js";
+import Results from "../core/results.js";
 export default class EntrySend {
     static #pathnameOf(statement) {
         const path = statement.target;
         if (path === null)
             return null;
-        if (path.kind === "regex")
-            return path.raw; // regex source — parens are syntax, never encoded
-        return decodePathParens(path.kind === "url" ? path.pathname : path.raw); // #239 item 4
+        return entryPathnameOf(path);
     }
     static #fragmentOf(statement) {
         const path = statement.target;
@@ -21,47 +20,73 @@ export default class EntrySend {
         return path.fragment;
     }
     static async sendToWorkspaceEntry(statement, ctx, scheme, explicitOwnerId) {
-        if (statement.target === null)
-            return { status: 400, error: "directed SEND requires a path" };
+        const failure = (code, status, detail, fields = {}, extensions = {}) => Results.failure(`scheme:${scheme}`, code, status, detail, fields, extensions);
+        if (statement.target === null) {
+            return failure("target-required", 400, "Directed SEND requires a target path.", {}, {
+                recovery: "Provide the target path.",
+                retryable: false,
+            });
+        }
         const status = statement.signal;
-        if (status === null)
-            return { status: 400, error: "SEND requires a numeric status code" };
-        // SEND[410] Gone — delete the targeted resource (SPEC §send-dispatch). With a
+        if (status === null) {
+            return failure("status-required", 400, "SEND requires a numeric status code.", {}, {
+                recovery: "Provide a numeric SEND status.",
+                retryable: false,
+            });
+        }
+        // SEND[410] Gone — delete the targeted resource (SPEC {§send-dispatch}). With a
         // #fragment, deletes just that channel; without, deletes the whole entry.
         if (status === 410) {
             const pathname = EntrySend.#pathnameOf(statement);
             if (pathname === null)
-                return { status: 400 };
+                return failure("target-required", 400, "SEND[410] requires a target path.");
+            const target = renderAddress(scheme, pathname);
             const fragment = EntrySend.#fragmentOf(statement);
             if (fragment !== null) {
                 const { db, workspaceId } = ctx;
                 const entry = await db.crud_find_workspace_entry.get({ workspace_id: workspaceId, owner_id: explicitOwnerId ?? await Owner.commonsId(db, workspaceId), scheme, pathname });
-                if (entry === undefined)
-                    return { status: 404 };
+                if (entry === undefined) {
+                    return failure("entry-not-found", 404, `No entry exists at ${target}.`, {}, { target });
+                }
                 const deleted = await db.crud_delete_channel.get({ entry_id: entry.id, name: fragment });
-                return { status: deleted === undefined ? 404 : 200 };
+                return deleted === undefined
+                    ? failure("channel-not-found", 404, `No channel named #${fragment} exists at ${target}.`, {}, {
+                        target,
+                        channel: fragment,
+                    })
+                    : { status: 200 };
             }
             const result = await EntryCrud.deleteEntry(pathname, ctx, scheme, explicitOwnerId);
-            return { status: result.status };
+            return result;
         }
-        // SEND[499] Client Closed Request — cancel active subscription (SPEC §send-dispatch, §stream-control).
+        // SEND[499] Client Closed Request — cancel active subscription (SPEC {§send-dispatch}, {§stream-control}).
         // Entry-bearing schemes never have subscriptions in v0; always return 404.
         // Streaming schemes (sse / exec / etc.) override this and look up via
         // findActiveSubscription, then call their teardown using the stored handle.
         if (status === 499) {
             const pathname = EntrySend.#pathnameOf(statement);
             if (pathname === null)
-                return { status: 400 };
+                return failure("target-required", 400, "SEND[499] requires a target path.");
+            const target = renderAddress(scheme, pathname);
             const { db, workspaceId, workerId } = ctx;
             const entry = await db.crud_find_workspace_entry.get({ workspace_id: workspaceId, owner_id: explicitOwnerId ?? await Owner.commonsId(db, workspaceId), scheme, pathname });
-            if (entry === undefined)
-                return { status: 404, error: "no entry at path" };
+            if (entry === undefined) {
+                return failure("entry-not-found", 404, `No entry exists at ${target}.`, {}, { target });
+            }
             const subscription = await ChannelWrite.findActiveSubscription(db, { workerId, entryId: entry.id });
-            if (subscription === null)
-                return { status: 404, error: "no active subscription to cancel" };
-            return { status: 501, error: `entry scheme does not own subscription cancellation; subscription owned by scheme '${subscription.scheme}'` };
+            if (subscription === null) {
+                return failure("subscription-not-found", 404, `No active subscription exists at ${target}.`, {}, { target });
+            }
+            return failure("subscription-owned-elsewhere", 501, `Scheme '${subscription.scheme}' owns cancellation for this subscription.`, {}, {
+                target,
+                owningScheme: subscription.scheme,
+                retryable: false,
+            });
         }
-        return { status: 501, error: `entry scheme does not interpret SEND status ${status}` }; // §send-dispatch-entry-schemes-501-on-non-410
+        return failure("status-not-implemented", 501, `The '${scheme}' entry scheme does not interpret SEND status ${status}.`, {}, {
+            requestedStatus: status,
+            retryable: false,
+        }); // {§send-dispatch-entry-schemes-501-on-non-410}
     }
 }
 //# sourceMappingURL=_entry-send.js.map

package/dist/schemes/_entry-send.js.map

@@ -1 +1 @@
-{"version":3,"file":"_entry-send.js","sourceRoot":"","sources":["../../src/schemes/_entry-send.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"_entry-send.js","sourceRoot":"","sources":["../../src/schemes/_entry-send.ts"],"names":[],"mappings":"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"}

package/dist/schemes/_path-scope.d.ts

@@ -0,0 +1,23 @@
+export type PathScope = {
+    kind: "exact";
+    pathname: string;
+    candidatePrefix: string;
+} | {
+    kind: "folder";
+    prefix: string;
+    candidatePrefix: string;
+} | {
+    kind: "glob";
+    pattern: string;
+    candidatePrefix: string | null;
+    shallowPrefix: string | null;
+    recursivePrefix: string | null;
+};
+export declare const pathScope: (pathname: string, folderScopes: boolean) => PathScope;
+export declare const pathScopeMatches: (scope: PathScope, pathname: string) => boolean;
+export type PathFolderSummary = {
+    selector: string;
+    pathnames: string[];
+};
+export declare const pathFolderSummaries: (scope: PathScope, pathnames: readonly string[]) => PathFolderSummary[];
+//# sourceMappingURL=_path-scope.d.ts.map

package/dist/schemes/_path-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_path-scope.d.ts","sourceRoot":"","sources":["../../src/schemes/_path-scope.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAC3D;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEN,eAAO,MAAM,SAAS,aAAc,MAAM,gBAAgB,OAAO,KAAG,SAanE,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,SAAS,YAAY,MAAM,KAAG,OAarE,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAKF,eAAO,MAAM,mBAAmB,UACrB,SAAS,aACL,SAAS,MAAM,EAAE,KAC7B,iBAAiB,EAgBnB,CAAC"}

package/dist/schemes/_path-scope.js

@@ -0,0 +1,61 @@
+import { posix } from "node:path";
+import { PathSyntax } from "@plurnk/plurnk-contracts";
+export const pathScope = (pathname, folderScopes) => {
+    if (folderScopes && (pathname === "" || pathname.endsWith("/"))) {
+        return { kind: "folder", prefix: pathname, candidatePrefix: pathname };
+    }
+    const magic = PathSyntax.globMagicIndex(pathname);
+    if (magic < 0)
+        return { kind: "exact", pathname, candidatePrefix: pathname };
+    const candidatePrefix = magic === 0 ? null : pathname.slice(0, magic);
+    const shallowPrefix = pathname[magic] === "*" && pathname[magic + 1] !== "*"
+        && magic === pathname.length - 1
+        ? pathname.slice(0, magic)
+        : null;
+    const recursivePrefix = pathname.slice(magic) === "**" ? pathname.slice(0, magic) : null;
+    return { kind: "glob", pattern: pathname, candidatePrefix, shallowPrefix, recursivePrefix };
+};
+export const pathScopeMatches = (scope, pathname) => {
+    if (scope.kind === "exact")
+        return pathname === scope.pathname;
+    if (scope.kind === "folder")
+        return pathname.startsWith(scope.prefix);
+    // Terminal `*` and `**` are the structural catalog selectors. They include
+    // dot entries so the promised complete map cannot hide `.env.defaults` or
+    // `.github`; richer shell patterns retain Node's native dotfile behavior.
+    if (scope.shallowPrefix !== null) {
+        if (!pathname.startsWith(scope.shallowPrefix))
+            return false;
+        const remainder = pathname.slice(scope.shallowPrefix.length);
+        return remainder.length > 0 && !remainder.includes("/");
+    }
+    if (scope.recursivePrefix !== null)
+        return pathname.startsWith(scope.recursivePrefix);
+    return posix.matchesGlob(pathname, scope.pattern);
+};
+// A terminal single-star glob is a one-level catalog. Real entries at that
+// level remain ordinary results; deeper entries collapse under an actionable
+// `dir/**` selector that describes exactly the subtree being summarized.
+export const pathFolderSummaries = (scope, pathnames) => {
+    if (scope.kind !== "glob" || scope.shallowPrefix === null)
+        return [];
+    const bySelector = new Map();
+    for (const pathname of pathnames) {
+        if (!pathname.startsWith(scope.shallowPrefix))
+            continue;
+        const remainder = pathname.slice(scope.shallowPrefix.length);
+        const slash = remainder.indexOf("/");
+        if (slash < 0)
+            continue;
+        const selector = `${scope.shallowPrefix}${remainder.slice(0, slash + 1)}**`;
+        const members = bySelector.get(selector);
+        if (members === undefined)
+            bySelector.set(selector, [pathname]);
+        else
+            members.push(pathname);
+    }
+    return [...bySelector.entries()]
+        .map(([selector, members]) => ({ selector, pathnames: members }))
+        .toSorted((a, b) => a.selector.localeCompare(b.selector));
+};
+//# sourceMappingURL=_path-scope.js.map

package/dist/schemes/_path-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_path-scope.js","sourceRoot":"","sources":["../../src/schemes/_path-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAatD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,YAAqB,EAAa,EAAE;IAC5E,IAAI,YAAY,IAAI,CAAC,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC7E,MAAM,eAAe,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;WACrE,KAAK,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC;QAChC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC1B,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAChG,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAgB,EAAE,QAAgB,EAAW,EAAE;IAC5E,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC;IAC/D,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtE,2EAA2E;IAC3E,0EAA0E;IAC1E,0EAA0E;IAC1E,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5D,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7D,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC,CAAC;AAOF,2EAA2E;AAC3E,6EAA6E;AAC7E,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAC/B,KAAgB,EAChB,SAA4B,EACT,EAAE;IACrB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC/C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC;YAAE,SAAS;QACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,KAAK,GAAG,CAAC;YAAE,SAAS;QACxB,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC;QAC5E,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,SAAS;YAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;;YAC3D,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;SAChE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC"}

package/dist/schemes/_search-candidate.d.ts

@@ -0,0 +1,20 @@
+export interface SearchCandidate {
+    readonly key: string;
+    readonly deepHash: string;
+}
+export interface SearchAttachment {
+    readonly key: string;
+    readonly deepHash: string | null;
+}
+export type SearchCandidateSet = {
+    readonly state: "ready";
+    readonly candidates: readonly SearchCandidate[];
+    readonly indexed: number;
+    readonly total: number;
+} | {
+    readonly state: "incomplete";
+    readonly indexed: number;
+    readonly total: number;
+};
+export declare const resolveSearchCandidates: (attachments: readonly SearchAttachment[]) => SearchCandidateSet;
+//# sourceMappingURL=_search-candidate.d.ts.map

package/dist/schemes/_search-candidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_search-candidate.d.ts","sourceRoot":"","sources":["../../src/schemes/_search-candidate.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,kBAAkB,GACxB;IACE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,GACC;IACE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,eAAO,MAAM,uBAAuB,gBACnB,SAAS,gBAAgB,EAAE,KACzC,kBAiBF,CAAC"}

package/dist/schemes/_search-candidate.js

@@ -0,0 +1,19 @@
+export const resolveSearchCandidates = (attachments) => {
+    const candidates = attachments.flatMap(({ key, deepHash }) => deepHash === null
+        ? []
+        : [{ key, deepHash }]);
+    if (candidates.length !== attachments.length) {
+        return {
+            state: "incomplete",
+            indexed: candidates.length,
+            total: attachments.length,
+        };
+    }
+    return {
+        state: "ready",
+        candidates,
+        indexed: candidates.length,
+        total: attachments.length,
+    };
+};
+//# sourceMappingURL=_search-candidate.js.map

package/dist/schemes/_search-candidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_search-candidate.js","sourceRoot":"","sources":["../../src/schemes/_search-candidate.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACnC,WAAwC,EACtB,EAAE;IACpB,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,IAAI;QAC3E,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC3B,IAAI,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;QAC3C,OAAO;YACH,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,UAAU,CAAC,MAAM;YAC1B,KAAK,EAAE,WAAW,CAAC,MAAM;SAC5B,CAAC;IACN,CAAC;IACD,OAAO;QACH,KAAK,EAAE,OAAO;QACd,UAAU;QACV,OAAO,EAAE,UAAU,CAAC,MAAM;QAC1B,KAAK,EAAE,WAAW,CAAC,MAAM;KAC5B,CAAC;AACN,CAAC,CAAC"}

package/dist/schemes/_search-exclusion.d.ts

@@ -0,0 +1,7 @@
+type SearchIdentity = {
+    scheme: string;
+    pathname: string;
+};
+export default function matchSearchExclusion({ scheme, pathname }: SearchIdentity): string | undefined;
+export {};
+//# sourceMappingURL=_search-exclusion.d.ts.map

package/dist/schemes/_search-exclusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_search-exclusion.d.ts","sourceRoot":"","sources":["../../src/schemes/_search-exclusion.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAeF,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAMrG"}

package/dist/schemes/_search-exclusion.js

@@ -0,0 +1,23 @@
+import { globToRegex } from "@plurnk/plurnk-mimetypes";
+const cache = new Map();
+function compile(raw) {
+    const cached = cache.get(raw);
+    if (cached !== undefined)
+        return cached;
+    const patterns = raw.split(",")
+        .map((source) => source.trim())
+        .filter((source) => source.length > 0)
+        .map((source) => ({ source, regex: globToRegex(source) }));
+    cache.set(raw, patterns);
+    return patterns;
+}
+export default function matchSearchExclusion({ scheme, pathname }) {
+    if (scheme !== "file")
+        return undefined;
+    const raw = process.env.PLURNK_SERVICE_SEARCH_EXCLUDE;
+    if (raw === undefined || raw.trim() === "")
+        return undefined;
+    const basename = pathname.slice(pathname.lastIndexOf("/") + 1);
+    return compile(raw).find(({ source, regex }) => regex.test(source.includes("/") ? pathname : basename))?.source;
+}
+//# sourceMappingURL=_search-exclusion.js.map

package/dist/schemes/_search-exclusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_search-exclusion.js","sourceRoot":"","sources":["../../src/schemes/_search-exclusion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAOvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+C,CAAC;AAErE,SAAS,OAAO,CAAC,GAAW;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;SAC1B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;SAC9B,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;SACrC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzB,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAkB;IAC7E,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC;IACtD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;AACpH,CAAC"}

package/dist/schemes/_search-index.d.ts

@@ -0,0 +1,6 @@
+import type { PlurnkSchemeContext } from "../core/scheme-types.ts";
+export default class SearchIndex {
+    #private;
+    static maintain(ctx: PlurnkSchemeContext): Promise<void>;
+}
+//# sourceMappingURL=_search-index.d.ts.map

package/dist/schemes/_search-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_search-index.d.ts","sourceRoot":"","sources":["../../src/schemes/_search-index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AA0CnE,MAAM,CAAC,OAAO,OAAO,WAAW;;IAsG5B,OAAa,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8M7D;CAEJ"}