@struktoai/mirage-core/dist/core/gcal/scope.js

A Unified Virtual Filesystem For AI Agents

// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
import { EVENT_SUFFIX } from "../../vfs/gcal/event_entry.js";
import { ContentType } from "../../types.js";
import { Codec } from "../hierarchy/codec.js";
import { Scope, Slot, makeDetectScope } from "../hierarchy/scope.js";
import { validBucket } from "./day.js";
/** Whether a segment is shaped like an event filename. */
export function isEventName(text) {
    return text.endsWith(EVENT_SUFFIX);
}
// A bucket is a real date or a span of two, not merely date-shaped:
// 2026-02-30 must classify as invalid, or stat reports a directory every
// later call raises on. Whether it sits on the mount's grid is the
// accessor's question, since the table is shared by every mount.
export const BUCKET = new Codec({ validate: validBucket });
// The whole filename stays in the slot (no suffix strip): the id and the day
// are recovered by parseEventFilename, which needs the name as listed.
export const EVENT_NAME = new Codec({ validate: isEventName });
const CAL = [new Slot('calendar')];
const BUCKET_SEGS = [...CAL, new Slot('bucket', BUCKET)];
// One description of the tree: readdir, stat, read and unlink all classify
// through it, so the file surface and the write surface cannot disagree
// about what a path means. The calendar level is a plain name ("primary",
// or `label__id`), proven against the calendar list rather than decoded.
export const SCOPES = [
    new Scope({ kind: 'calendar', segments: CAL }),
    new Scope({
        kind: 'calendar_json',
        segments: [...CAL, 'calendar.json'],
        leaf: true,
        filetype: ContentType.JSON,
    }),
    new Scope({ kind: 'bucket', segments: BUCKET_SEGS }),
    new Scope({
        kind: 'event',
        segments: [...BUCKET_SEGS, new Slot('event', EVENT_NAME)],
        leaf: true,
        filetype: ContentType.JSON,
    }),
];
export const detectScope = makeDetectScope(SCOPES);
//# sourceMappingURL=scope.js.map